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://www.cite42.dev/api/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",
  "publishedAfter": "2026-06-20T12:00:00.000Z",
  "risingVideos": [
    {
      "videoId": "example123",
      "title": "Best AI video tools tested",
      "channelTitle": "Creator Lab",
      "channelId": "UCexample",
      "url": "https://www.youtube.com/watch?v=example123",
      "publishedAt": "2026-07-10T09:00:00.000Z",
      "descriptionSnippet": "A practical comparison of AI video tools.",
      "thumbnailUrl": "https://i.ytimg.com/vi/example123/hqdefault.jpg",
      "duration": "PT12M34S",
      "viewCount": 142000,
      "likeCount": 6300,
      "commentCount": 410,
      "viewsPerDay": 7100
    }
  ],
  "titlePatterns": [
    {
      "pattern": "Best/tools list",
      "count": 5,
      "examples": [
        "Best AI video tools tested"
      ]
    }
  ],
  "creatorAngles": [
    {
      "angle": "Review/test",
      "why": "Review framing suggests trust-building and proof are important in this topic.",
      "examples": [
        "Best AI video tools tested"
      ]
    }
  ],
  "channelBreakdown": [
    {
      "channelTitle": "Creator Lab",
      "videos": 2,
      "totalViews": 215000,
      "totalComments": 680
    }
  ],
  "formatIdeas": [
    "Publish a ranked tools video with clear use-case segments."
  ],
  "sourceUrls": [
    "https://www.youtube.com/watch?v=example123"
  ],
  "fetchedAt": "2026-07-20T12:00:00.000Z",
  "requestId": "…",
  "billing": {
    "cost": {
      "microCredits": 5000,
      "usd": "0.05"
    },
    "balance": {
      "microCredits": 1336000,
      "usd": "13.36"
    }
  }
}