Skip to main content
GET
https://api.pictory.ai
/
pictoryapis
/
v1
/
media
/
search
Search Videos and Images
curl --request GET \
  --url https://api.pictory.ai/pictoryapis/v1/media/search \
  --header 'Authorization: <authorization>'
{
  "data": {
    "page": 1,
    "searchResults": [
      {
        "assetId": 10900066,
        "duration": 15,
        "id": 10900066,
        "keyword": "business",
        "mediaDescription": "Young Team Brainstorming Ideas On Sticky Notes. Colleagues Approve. Business Success Concept.",
        "mediaType": "video",
        "preview": {
          "jpg": "https://dm0qx8t0i9gc9.cloudfront.net/thumbnails/video/V1xq1AADx/videoblocks-young-business-team-brainstorming-ideas-on-sticky-notes_thumbnail-180_02.jpg",
          "url": "https://dm0qx8t0i9gc9.cloudfront.net/watermarks/video/V1xq1AADx/videoblocks-young-business-team_P480.mp4"
        },
        "searchLibrary": "story_blocks",
        "thumbnail": {
          "jpg": "https://dm0qx8t0i9gc9.cloudfront.net/thumbnails/video/V1xq1AADx/videoblocks-young-business-team_thumbnail-180_02.jpg",
          "url": "https://dm0qx8t0i9gc9.cloudfront.net/watermarks/video/V1xq1AADx/videoblocks-young-business-team_P180.mp4"
        }
      }
    ]
  }
}

​
Overview

Search through Pictory’s integrated stock media libraries to find relevant videos and images for your projects. Results include preview URLs, thumbnails, duration information, and descriptive metadata from sources like StoryBlocks and Getty Images.
You need a valid API key to use this endpoint. Get your API key from the API Access page in your Pictory dashboard.

​
API Endpoint

GET https://api.pictory.ai/pictoryapis/v1/media/search

​
Request Parameters

​
Headers

​
Authorization
string
required
API key for authentication (starts with pictai_)
Authorization: YOUR_API_KEY

​
Query Parameters

​
keyword
string
required
Search keyword for which media (video/image) results are requiredExample: business, technology, nature
​
category
string
Filter results by category. Accepted values:
  • Agriculture and Forestry
  • Arts and Entertainment
  • Autos and Vehicles
  • Beauty and Fitness
  • Biological Sciences
  • Books and Literature
  • Business and Industrial
  • Computers and Electronics
  • Finance
  • Food and Drink
  • Games
  • Health
  • Home and Garden
  • Internet and Telecom
  • Jobs and Education
  • People and Society
  • Pets and Animals
  • Real Estate
  • Science
  • Sports
  • Travel
​
language
string
default:"en"
Language of the search keyword. Defaults to en (English)

​
Response

​
data
object

​
Response Examples

{
  "data": {
    "page": 1,
    "searchResults": [
      {
        "assetId": 10900066,
        "duration": 15,
        "id": 10900066,
        "keyword": "business",
        "mediaDescription": "Young Team Brainstorming Ideas On Sticky Notes. Colleagues Approve. Business Success Concept.",
        "mediaType": "video",
        "preview": {
          "jpg": "https://dm0qx8t0i9gc9.cloudfront.net/thumbnails/video/V1xq1AADx/videoblocks-young-business-team-brainstorming-ideas-on-sticky-notes_thumbnail-180_02.jpg",
          "url": "https://dm0qx8t0i9gc9.cloudfront.net/watermarks/video/V1xq1AADx/videoblocks-young-business-team_P480.mp4"
        },
        "searchLibrary": "story_blocks",
        "thumbnail": {
          "jpg": "https://dm0qx8t0i9gc9.cloudfront.net/thumbnails/video/V1xq1AADx/videoblocks-young-business-team_thumbnail-180_02.jpg",
          "url": "https://dm0qx8t0i9gc9.cloudfront.net/watermarks/video/V1xq1AADx/videoblocks-young-business-team_P180.mp4"
        }
      }
    ]
  }
}

​
Code Examples

Replace YOUR_API_KEY with your actual API key that starts with pictai_
curl --request GET \
  --url 'https://api.pictory.ai/pictoryapis/v1/media/search?keyword=business&language=en' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'accept: application/json' | python -m json.tool

​
Usage Notes

Media Sources: Search results are sourced from integrated stock media libraries including StoryBlocks and Getty Images. All preview URLs include watermarks for copyright protection.
Use the category parameter to filter results by topic and receive more relevant media that matches your specific use case and content theme.
Preview URLs contain time-sensitive security tokens that expire. Access or download media assets promptly after retrieval to avoid broken links.