Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
description: 'The Outdoorsy Search API is organized around REST. It uses
predictable, resource-oriented URLs and implements standard HTTP response
codes, verbs, authentication mechanisms, and a variety of request encodings.
## Versioning
The API implements semantic versioning.'
title: Outdoorsy Search Documentation Parks API
version: 0.0.1
security:
- Bearer:
- '[]'
tags:
- name: Parks
paths:
/parks:
get:
description: Search performs search on parks
tags:
- Parks
operationId: searchParks
responses:
'200':
$ref: '#/components/responses/jsonApiRentalsResponse'
summary: Search parks
x-summary-source: derived
/parks/homepage:
get:
description: Get parks for Outdoorsy homepage
tags:
- Parks
operationId: parks
responses:
'200':
$ref: '#/components/responses/jsonApiHomepageParks'
summary: Parks
x-summary-source: derived
/parks/nearby-for-rental/{rental_id}:
get:
description: Searches nearby parks for given rental with rental_id
tags:
- Parks
operationId: searchParks
responses:
'200':
$ref: '#/components/responses/jsonApiRentalsResponse'
summary: Search parks
x-summary-source: derived
/parks/popular:
get:
description: Searches 6 national parks near location with images
tags:
- Parks
operationId: searchParks
responses:
'200':
$ref: '#/components/responses/jsonApiRentalsResponse'
summary: Search parks
x-summary-source: derived
/parks/{id}:
get:
description: Get park by id
tags:
- Parks
operationId: getPark
parameters:
- x-go-name: ID
name: id
in: path
required: true
schema:
type: integer
format: int64
responses:
'200':
$ref: '#/components/responses/jsonApiRentalsResponse'
summary: Get park
x-summary-source: derived
components:
responses:
jsonApiHomepageParks:
description: ''
content:
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/Resource'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Resource'
jsonApiRentalsResponse:
description: ''
content:
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/Resource'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Resource'
schemas:
Resource:
description: 'Note that any of the optional keys will be omitted if a value is not provided.
For more information, see the specification at:
http://jsonapi.org/format/#document-resource-object
http://jsonapi.org/format/#document-resource-identifier-objects'
type: object
title: 'Resource represents a JSON API resource identifier or resource object.
Each valid JSON API resource object must contain at least the "id" and "type" keys,
and may contain the optional "attributes", "relationships", "links" and "meta" keys.'
properties:
attributes:
type: object
additionalProperties: {}
x-go-name: Attributes
id:
type: string
x-go-name: ID
links:
$ref: '#/components/schemas/Links'
meta:
type: object
additionalProperties: {}
x-go-name: Meta
relationships:
$ref: '#/components/schemas/Relationships'
type:
type: string
x-go-name: Type
x-go-package: github.com/smotes/jsonapi
Links:
description: http://jsonapi.org/format/#document-links
type: object
title: Links represents a JSON API links object, which can include JSON API link objects or strings representing links.
additionalProperties: {}
x-go-package: github.com/smotes/jsonapi
Relationships:
description: http://jsonapi.org/format/#document-resource-object-relationships
type: object
title: Relationships represents a JSON API relationships object
additionalProperties:
$ref: '#/components/schemas/Relationship'
x-go-package: github.com/smotes/jsonapi
Relationship:
type: object
title: Relationship represents a member of the JSON API relationships object.
properties:
data:
type: object
x-go-name: Data
links:
$ref: '#/components/schemas/Links'
meta:
type: object
additionalProperties: {}
x-go-name: Meta
x-go-package: github.com/smotes/jsonapi
securitySchemes:
Bearer:
type: apiKey
name: Authorization
in: header