Perplexity media results schema

This section documents the media data returned by the Perplexity endpoint: videos and images Perplexity surfaces when they are relevant to the query, part of the Perplexity response so no separate API call is needed. Each media type appears in the order Perplexity ranks it; array index 0 is the top result. For use cases, pricing context, and copy-paste examples, see the Perplexity media API page on the product site.

Example request

Media is surfaced based on query relevance; send a prompt where videos or images are likely to be useful (tutorials, visual subjects, news coverage). No flag is required.

{
  "prompt": "how to change a bicycle tire",
  "country": "US"
}

Media structure

Field	Type	Description
`result.videos`	array	Video content found in response
`result.images`	array	Image content found in response

Media item structure

Field	Type	Description
`title`	string	Media title
`url`	string	Media URL
`thumbnail`	string	Thumbnail URL
`medium`	string	Media type (“video”, “image”)
`source`	string	Source platform (“youtube”, “stock_photo”, etc.)
`image_width`	number	Original image width
`image_height`	number	Original image height
`thumbnail_width`	number	Thumbnail width
`thumbnail_height`	number	Thumbnail height

Response example

{
  "success": true,
  "result": {
    "text": "Changing a bicycle tire is straightforward once you know the steps...",
    "videos": [
      {
        "title": "How to Change a Bike Tire",
        "url": "https://www.youtube.com/watch?v=example",
        "thumbnail": "https://i.ytimg.com/vi/example/hqdefault.jpg",
        "medium": "video",
        "source": "youtube",
        "thumbnail_width": 480,
        "thumbnail_height": 360
      }
    ],
    "images": [
      {
        "title": "Bicycle tire replacement",
        "url": "https://example.com/tire.jpg",
        "thumbnail": "https://example.com/tire-thumb.jpg",
        "medium": "image",
        "source": "stock_photo",
        "image_width": 1920,
        "image_height": 1080,
        "thumbnail_width": 320,
        "thumbnail_height": 180
      }
    ]
  }
}

⌘I

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Perplexity media results schema

Example request

Media structure

Media item structure

Response example

​Example request

​Media structure

​Media item structure

​Response example

Example request

Media structure

Media item structure

Response example