---
title: "Search configured stock photo and video providers"
method: GET
path: "/stock-media/search"
tags: ["Stock Media"]
---

# Search configured stock photo and video providers

`GET /stock-media/search`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/stock-media/search`
- Auth: none required

## Query parameters

- `provider` 'pexels' | 'unsplash' | 'pixabay', required
- `query` string, required
- `kind` 'photo' | 'video'
- `orientation` 'landscape' | 'portrait' | 'square'
- `size` 'small' | 'medium' | 'large'
- `color` string
- `locale` string
- `order` 'relevant' | 'latest' | 'popular'
- `content_filter` 'low' | 'high'
- `collections` string
- `category` string
- `media_subtype` 'all' | 'photo' | 'illustration' | 'vector'
- `editors_choice` boolean
- `min_width` integer
- `min_height` integer
- `page` integer
- `per_page` integer

## Response `200`

OK

- SearchPage
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `has_more` boolean, required
  - `items` Asset[], nullable, required
    - `attribution_text` string, required
    - `creator_name` string, required
    - `creator_url` string, required
    - `duration_seconds` integer
    - `external_id` string, required
    - `height` integer, required
    - `kind` string, required
    - `license_name` string, required
    - `license_url` string, required
    - `preview_url` string
    - `provider` string, required
    - `provider_url` string, required
    - `source_url` string, required
    - `thumbnail_url` string, required
    - `title` string, required
    - `width` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `provider` string, required
  - `provider_url` string, required
  - `total` integer, required

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)