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 · 42 reviews
The result.videos and result.images arrays are included in the base 3-credit request whenever Perplexity renders media.
from cloro import Cloro
client = Cloro(api_key="sk_live_your_api_key_here")
response = client.monitor.perplexity(
prompt="how to install a smart thermostat",
country="US",
)
print(response["result"]["text"]){
"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. |
Start free. Price per credit drops as your volume grows — see every tier below.
| Plan | Price / mo | Credits | Per 1k | Concurrency | Seats | Support |
|---|---|---|---|---|---|---|
| Free | $0 | 500 | — | 1 | 1 | Community |
| Lite | $30 | 37,500 | $0.80 | 10 | Unlimited | |
| Hobby | $100 | 250,000 | $0.40 | 20 | Unlimited | |
| StarterPopular | $250 | 650,000 | $0.39 | 50 | Unlimited | |
| Growth | $500 | 1,350,000 | $0.37 | 75 | Unlimited | Priority email |
| Business | $1,000 | 2,800,000 | $0.36 | 100 | Unlimited | Priority email |
| Enterprise 2K | $2,000 | 5,871,025 | $0.34 | 135 | Unlimited | Slack |
| Enterprise 3K | $3,000 | 9,306,606 | $0.32 | 175 | Unlimited | Slack |
| Enterprise 4K | $4,000 | 12,756,261 | $0.31 | 215 | Unlimited | Slack |
| Enterprise 5K | $5,000 | 16,391,783 | $0.31 | 255 | Unlimited | Slack |
| Enterprise | $5,000+ | Increased concurrency, overages on credits and credit discounts for annual contracts.Know more | ||||
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.