Skip to main content
This section documents the media data returned by the Perplexity endpoint. Media is part of the Perplexity response, so no separate API call is needed. 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.
This produces a response containing the videos and images arrays documented below.

Overview

Perplexity automatically surfaces videos and images relevant to the query. Media items are returned in the videos and images arrays. Videos and images appear in the order Perplexity ranks them; array index 0 is the top result for each media type.
Videos in Perplexity

Media structure

Each media item includes:

Response example