OpenPost Stock Media API

The Stock Media API from OpenPost — 3 operation(s) for stock media.

GitHub OpenAPI

Operations 3

GET /stock-media/providers List configured stock media providers #
GET /stock-media/search Search configured stock photo and video providers #
POST /stock-media/selections Resolve a selected stock asset and record provider attribution events #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/openpo-st:openpo-st-stock-media-api"
All apis
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.

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. 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 Specification

openpo-st-stock-media-api-openapi.yml Raw ↑
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