Perplexity decorates answers with a media rail — the videos and images it judged most relevant. cloro returns both arrays as structured JSON: title, URL, thumbnail, source platform, and dimensions per item. See whose videos own your category prompts — and whether yours ever appear.
4.8 · 33 reviews
The result.videos and result.images arrays are included in the base 3-credit request whenever Perplexity renders media.
import requests
response = requests.post(
"https://api.cloro.dev/v1/monitor/perplexity",
headers={
"Authorization": "Bearer sk_live_your_api_key_here",
"Content-Type": "application/json"
},
json={
"prompt": "how to install a smart thermostat",
"country": "US"
}
)
print(response.json()){
"success": true,
"result": {
"text": "Installing a smart thermostat takes about 30 minutes...",
"videos": [
{
"title": "Smart Thermostat Installation — Full Walkthrough",
"url": "https://www.youtube.com/watch?v=example123",
"thumbnail": "https://i.ytimg.com/vi/example123/hqdefault.jpg",
"medium": "video",
"source": "youtube",
"thumbnail_width": 480,
"thumbnail_height": 360
}
],
"images": [
{
"title": "Thermostat wiring diagram",
"url": "https://example.com/wiring-diagram.jpg",
"thumbnail": "https://example.com/wiring-diagram-thumb.jpg",
"medium": "image",
"source": "stock_photo",
"image_width": 1600,
"image_height": 900
}
]
}
} videos and images share one item shape, discriminated by the medium field.
| Field | Type | Description |
|---|---|---|
| title / url | string | Media title and canonical URL. |
| thumbnail | string | Thumbnail URL. |
| medium | string | Media type: "video" or "image". |
| source | string | Source platform (e.g. "youtube", "stock_photo") — aggregate by it to see which platforms win media placement. |
| image_width / image_height | number | Original image dimensions. |
| thumbnail_width / thumbnail_height | number | Thumbnail dimensions. |
Pick a plan that fits your volume. Price per credit drops as you scale.
Increased concurrency, overages on credits and credit discounts for annual contracts.
Know moreCredit cost per request varies by provider. The rates below apply to async/batch requests; sync requests add a +2 credit surcharge.
ChatGPT full response includes query fan-out, ads, and shopping data. Google News uses the same pricing as Google Search.
For how-to, product, and comparison prompts, the video slot gets clicks the text answer doesn't — it's the most visually dominant element on the page. If a competitor's YouTube walkthrough owns that slot on your category prompts, they're capturing your demand at the exact research moment.
Its intent classifier decides per prompt: how-to and visual-product prompts get videos, informational prompts often get images, and many prompts get none. Treat both arrays as optional and sample repeatedly — media presence itself is a trackable signal.
Yes — every item carries source (platform) and a canonical URL, so you can aggregate which platforms and which specific videos win placement across your prompt set over time.
No — videos and images ship in the base 3-credit request alongside sources and citation pills and shopping cards. See pricing.
Media placement and citations are separate selections — a video can appear without its channel being cited in the answer. Tracking both (this endpoint returns them in one response) shows whether your video content or your written content is doing the work.