OpenPost Stock Media API
The Stock Media API from OpenPost — 3 operation(s) for stock media.
Operations 3
POST
/stock-media/selections
Resolve a selected stock asset and record provider attribution events
#
The Stock Media API from OpenPost — 3 operation(s) for stock media.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/openpo-st:openpo-st-stock-media-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
contact:
email: hello@openpo.st
name: OpenPost support
url: https://openpo.st/contact
description: OpenPost HTTP API for workspace-scoped social publishing. Use it to inspect accounts and provider readiness, manage media and publications, schedule work, and read publishing results. Every operation still follows token scopes, workspace roles, plan limits, provider capabilities, and destination validation.
license:
identifier: AGPL-3.0-only
name: AGPL-3.0-only
termsOfService: https://openpo.st/terms
title: OpenPost Stock Media API
version: 1.0.0
servers:
- description: OpenPost Hosted service
url: https://app.openpo.st/api/v1
- description: The OpenPost instance serving this contract
url: /api/v1
security:
- bearerAuth: []
- sessionCookie: []
tags:
- name: Stock Media
paths:
/stock-media/providers:
get:
operationId: list-stock-media-providers
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ListStockProvidersOutputBody'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
security: []
summary: List configured stock media providers
tags:
- Stock Media
/stock-media/search:
get:
operationId: search-stock-media
parameters:
- explode: false
in: query
name: provider
required: true
schema:
enum:
- pexels
- unsplash
- pixabay
type: string
- explode: false
in: query
name: query
required: true
schema:
maxLength: 120
minLength: 1
type: string
- explode: false
in: query
name: kind
schema:
default: photo
enum:
- photo
- video
type: string
- explode: false
in: query
name: orientation
schema:
enum:
- landscape
- portrait
- square
type: string
- explode: false
in: query
name: size
schema:
enum:
- small
- medium
- large
type: string
- explode: false
in: query
name: color
schema:
maxLength: 80
type: string
- explode: false
in: query
name: locale
schema:
maxLength: 12
type: string
- explode: false
in: query
name: order
schema:
enum:
- relevant
- latest
- popular
type: string
- explode: false
in: query
name: content_filter
schema:
enum:
- low
- high
type: string
- explode: false
in: query
name: collections
schema:
maxLength: 500
type: string
- explode: false
in: query
name: category
schema:
maxLength: 40
type: string
- explode: false
in: query
name: media_subtype
schema:
enum:
- all
- photo
- illustration
- vector
type: string
- explode: false
in: query
name: editors_choice
schema:
type: boolean
- explode: false
in: query
name: min_width
schema:
format: int64
maximum: 20000
minimum: 0
type: integer
- explode: false
in: query
name: min_height
schema:
format: int64
maximum: 20000
minimum: 0
type: integer
- explode: false
in: query
name: page
schema:
default: 1
format: int64
maximum: 500
minimum: 1
type: integer
- explode: false
in: query
name: per_page
schema:
default: 24
format: int64
maximum: 40
minimum: 1
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SearchPage'
description: OK
headers:
Cache-Control:
schema:
type: string
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Request
'404':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Not Found
'422':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Unprocessable Entity
'429':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Too Many Requests
'500':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Internal Server Error
'502':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Gateway
'503':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Service Unavailable
security: []
summary: Search configured stock photo and video providers
tags:
- Stock Media
/stock-media/selections:
post:
operationId: select-stock-media
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SelectStockMediaInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ResolvedAsset'
description: OK
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Request
'404':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Not Found
'422':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Unprocessable Entity
'429':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Too Many Requests
'500':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Internal Server Error
'502':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Gateway
'503':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Service Unavailable
security: []
summary: Resolve a selected stock asset and record provider attribution events
tags:
- Stock Media
components:
schemas:
Asset:
additionalProperties: false
properties:
attribution_text:
type: string
creator_name:
type: string
creator_url:
type: string
duration_seconds:
format: int64
type: integer
external_id:
type: string
height:
format: int64
type: integer
kind:
type: string
license_name:
type: string
license_url:
type: string
preview_url:
type: string
provider:
type: string
provider_url:
type: string
source_url:
type: string
thumbnail_url:
type: string
title:
type: string
width:
format: int64
type: integer
required:
- external_id
- kind
- title
- width
- height
- thumbnail_url
- source_url
- creator_name
- creator_url
- provider
- provider_url
- attribution_text
- license_name
- license_url
type: object
ListStockProvidersOutputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/ListStockProvidersOutputBody.json
format: uri
readOnly: true
type: string
enabled:
type: boolean
providers:
items:
$ref: '#/components/schemas/StockProviderResponse'
type:
- array
- 'null'
required:
- enabled
- providers
type: object
ErrorModel:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/ErrorModel.json
format: uri
readOnly: true
type: string
detail:
description: A human-readable explanation specific to this occurrence of the problem.
examples:
- Property foo is required but is missing.
type: string
errors:
description: Optional list of individual error details
items:
$ref: '#/components/schemas/ErrorDetail'
type:
- array
- 'null'
instance:
description: A URI reference that identifies the specific occurrence of the problem.
examples:
- https://example.com/error-log/abc123
format: uri
type: string
status:
description: HTTP status code
examples:
- 400
format: int64
type: integer
title:
description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
examples:
- Bad Request
type: string
type:
default: about:blank
description: A URI reference to human-readable documentation for the error.
examples:
- https://example.com/errors/example
format: uri
type: string
type: object
ResolvedAsset:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/ResolvedAsset.json
format: uri
readOnly: true
type: string
attribution_text:
type: string
creator_name:
type: string
creator_url:
type: string
download_url:
type: string
duration_seconds:
format: int64
type: integer
external_id:
type: string
height:
format: int64
type: integer
kind:
type: string
license_name:
type: string
license_url:
type: string
mime_type:
type: string
preview_url:
type: string
provider:
type: string
provider_url:
type: string
source_url:
type: string
thumbnail_url:
type: string
title:
type: string
width:
format: int64
type: integer
required:
- download_url
- mime_type
- external_id
- kind
- title
- width
- height
- thumbnail_url
- source_url
- creator_name
- creator_url
- provider
- provider_url
- attribution_text
- license_name
- license_url
type: object
SelectStockMediaInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/SelectStockMediaInputBody.json
format: uri
readOnly: true
type: string
external_id:
maxLength: 160
minLength: 1
type: string
provider:
enum:
- pexels
- unsplash
- pixabay
type: string
required:
- provider
- external_id
type: object
SearchPage:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/SearchPage.json
format: uri
readOnly: true
type: string
has_more:
type: boolean
items:
items:
$ref: '#/components/schemas/Asset'
type:
- array
- 'null'
page:
format: int64
type: integer
per_page:
format: int64
type: integer
provider:
type: string
provider_url:
type: string
total:
format: int64
type: integer
required:
- items
- page
- per_page
- total
- has_more
- provider
- provider_url
type: object
StockProviderResponse:
additionalProperties: false
properties:
attribution:
type: string
audio:
type: boolean
key:
type: string
name:
type: string
photo_filters:
items:
type: string
type:
- array
- 'null'
photos:
type: boolean
provider_url:
type: string
video_filters:
items:
type: string
type:
- array
- 'null'
videos:
type: boolean
required:
- key
- name
- provider_url
- photos
- videos
- audio
- attribution
type: object
ErrorDetail:
additionalProperties: false
properties:
location:
description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
type: string
message:
description: Error message text
type: string
value:
description: The value at the given location
type: object
securitySchemes:
bearerAuth:
bearerFormat: OpenPost API token or session JWT
scheme: bearer
type: http
sessionCookie:
in: cookie
name: openpost_session
type: apiKey