YouTube Hashtag Search API

What is the YouTube Hashtag Search API?

Pass a hashtag (with or without #) and get the videos listed on YouTube's hashtag page as clean JSON. This is the /hashtag/{name} feed — not a search?q= keyword query. A query with spaces (travel blog) is 400 HASHTAG_HAS_SPACES — YouTube hashtag pages are one token; nothing is fetched. Use /v1/youtube/search for a keyword phrase. Titles often omit the #tag (it may live only in the description); association is the hashtag page itself. Envelope field is hashtag (the normalized tag). Each result includes type (video|short|live), id, url, title, nested channel{id,title,handle?,url}, viewCount + viewCountIsApproximate, and durationSeconds when YouTube exposes them. Returns a single window; use limit to size it. No cursor. Billed per returned result (~1 credit each).

What you get

• Hashtag page feed (not keyword search)
• type: video | short | live on every row
• Nested channel{} — no flat channelName/channelId twins
• viewCountIsApproximate on every row with viewCount
• Returns a single window; use limit to size it. No cursor.

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/youtube/hashtag-search?q=structured%20data%20api" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "hashtag": "music",
    "totalReturned": 2,
    "results": [
      {
        "type": "video",
        "id": "O40ruQpZogY",
        "url": "https://www.youtube.com/watch?v=O40ruQpZogY",
        "title": "Seriously This is One of The Most Beautiful Songs Ever Made 🥹😭",
        "publishedTimeApprox": "2026-05-21T00:00:00.000Z",
        "publishedTimeIsApproximate": true,
        "publishedTimeText": "5mo ago",
        "viewCount": 1246689,
        "viewCountText": "1,246,689 views",
        "viewCountIsApproximate": false,
        "durationSeconds": 274,
        "thumbnailUrl": "https://i.ytimg.com/vi/O40ruQpZogY/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBC0XgAcnqjC4tJjLDnhGB-6j47pQ",
        "channel": {
          "id": "UC0nOQ1R3Z-vRO7K6g-W7Jkg",
          "title": "Fearless Soul",
          "url": "https://www.youtube.com/channel/UC0nOQ1R3Z-vRO7K6g-W7Jkg",
          "thumbnail": "https://yt3.ggpht.com/ytc/AIdro_lAqUplsi-NTA6PEHA-j_xrqt4yZmaBBbzrDbflSgIDeSQ=s68-c-k-c0x00ffffff-no-rj"
        },
        "badges": [
          "Verified"
        ]
      },
      {
        "type": "video",
        "id": "YWZyuz7o8cw",
        "url": "https://www.youtube.com/watch?v=YWZyuz7o8cw",
        "title": "Best Hillsong Worship Songs 2026 ✝️ Nonstop Christian Praise & Worship Music",
        "publishedTimeApprox": "2026-03-22T00:00:00.000Z",
        "publishedTimeIsApproximate": true,
        "publishedTimeText": "7mo ago",
        "viewCount": 1630160,
        "viewCountText": "1,630,160 views",
        "viewCountIsApproximate": false,
        "durationSeconds": 5092,
        "thumbnailUrl": "https://i.ytimg.com/vi/YWZyuz7o8cw/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAOuOpQLSJGcGK6DjO8MRUpZRk1sg",
        "channel": {
          "id": "UCoVIa3ZXcRl3OqG6V10juOA",
          "title": "Best Worship Songs",
          "url": "https://www.youtube.com/channel/UCoVIa3ZXcRl3OqG6V10juOA",
          "thumbnail": "https://yt3.ggpht.com/UsU3lqlf-c1ovAX2xyQCzmsto40ZGtPu0bgPwhdzRYUPJlD3yp5Xz_LE2ZVJ8d_htOrx4YkgkA=s68-c-k-c0x00ffffff-no-rj"
        },
        "badges": null
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Request-Id (include it when contacting support). Where the response has a source field, it names the path that served the data: native, extended, cache or asr. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs ~20 credits (1/result) — billed per result, so the exact amount scales with how many items you request. Pass cache=true for a free 24h cache hit; default is always fresh (metrics refresh within ~1 hour).

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/youtube/hashtag-search and parse the JSON response.

Use cases

Frequently asked questions

More YouTube APIs