YouTube Trends

YouTube market-data endpoint for rising videos, title patterns, creator angles, and format ideas.

Overview

Pulls recent YouTube videos for a topic via the YouTube Data API, enriches them with video statistics, then returns rising videos, title patterns, creator angles, channel examples, and format ideas.

Reference

POST/v1/youtube/trends

$0.05 · flat per call

Parameters

`topic`required	string	Topic, keyword, niche, or audience to research on YouTube.
`region`optional	string	ISO-2 country/region code. Defaults to "US". Default: `"US"`.
`timeframe`optional	string	Video-market window, e.g. "past_7_days", "past_30_days", "past_90_days". Default: `"past_30_days"`.

Request

curl https://api.cite42.dev/v1/youtube/trends \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "topic": "AI tools for video creators", "region": "US" }'

Response

{
  "topic": "AI tools for video creators",
  "region": "US",
  "timeframe": "past_30_days",
  "provider": "youtube_data_api",
  "risingVideos": [
    { "title": "Best AI video tools tested", "channelTitle": "Creator Lab", "viewCount": 142000, "viewsPerDay": 7100 }
  ],
  "titlePatterns": [{ "pattern": "Best/tools list", "count": 5 }],
  "creatorAngles": [{ "angle": "Review/test", "why": "Review framing suggests trust-building and proof are important in this topic." }],
  "formatIdeas": ["Publish a ranked tools/options video with clear use-case segments."],
  "sourceUrls": ["https://www.youtube.com/watch?v=..."],
  "requestId": "…",
  "billing": { "cost": { "usd": "0.05" }, "balance": { "usd": "13.31" } }
}