Get started for $0
All APIs

YouTube API

Available

Read public YouTube data through 29 typed endpoints with the same key, caching, and usage tracking as every other platform.

Get your API keyRead the YouTube docs

$2.50 per 1,000 requests. Your first 100 are free, no card needed.

GET /v1/youtube/profiles/{identifier}
curl "https://api.openhandle.dev/v1/youtube/profiles/@synthetic_youtube" \
  -H "Authorization: Bearer $OPENHANDLE_TEST_KEY"
200 OK
{
  "platform": "youtube",
  "resource": "profile",
  "capturedAt": "2026-10-26T14:19:24.23027Z",
  "source": "live",
  "data": {
    "id": "UCsyntheticyoutube000001",
    "handle": "synthetic_youtube",
    "displayName": "Synthetic YouTube",
    "bio": "A fictional public YouTube channel for deterministic API testing. Business: synthetic [at] example.openhandle.dev",
    "extracted": {
      "emails": [
        "synthetic@example.openhandle.dev"
      ],
      "phones": [],
      "links": [],
      "handles": []
    },
    "url": "https://www.youtube.com/@synthetic_youtube",
    "country": "Netherlands",
    "joinedAt": "2014-03-02",
    "keywords": [
      "synthetic",
      "testing"
    ],
    "links": [
      {
        "title": "Website",
        "url": "https://example.openhandle.dev"
      }
    ],
    "avatar": {
      "url": "https://media.openhandle.dev/A9AZ9IF6ex7wg45xTXbWI-82l4PKXWp1ABRX3mavBJ_qSFD_L7h4WDjaSgLG5tTxfvoD7sr86cCCVlsupO31UHgH6v8SujLI2VLda1cxOmLXPCEgibDxGE4GQB4anwTAfabJ2-OYdSrQ9-nDo9ssasBGYwi7XjIhxO4j89c",
      "width": 176,
      "height": 176,
      "renditions": null
    },
    "banner": {
      "url": "https://media.openhandle.dev/A64NvHy5j3VoENGeO72Hs1oCx-9_NcnBq33BjfT04KK6Bpv3fh_MhtZf2XP1_Qp_E2gTP9FrPYyaHk-WE5BStrP3VbyjtBuaYiBn7agdeYg83_yhdtwnZoSePycZvBldg2kVTCy5wsuKZBJY-M1S_1vreYmklNFFdwKuF1I",
      "width": 2560,
      "height": 424,
      "renditions": null
    },
    "isFamilySafe": true,
    "hasBusinessEmail": true,
    "metrics": {
      "subscribers": 1280000,
      "videos": 12,
      "views": 98765432,
      "isApproximate": false
    }
  }
}

The real answer to this request with a free Test key. Test keys read a synthetic dataset, so your first call returns the same answer. Only the capture time and the signed media links differ.

Endpoints

Everything public on YouTube, 29 operations.

Profiles, posts, comments, and more, grouped by what they read. Each one is one call.

Profiles

8 operations
  • Get a profileGET /v1/youtube/profiles/{identifier}
  • List profile videosGET /v1/youtube/profiles/{identifier}/videos
  • List profile ShortsGET /v1/youtube/profiles/{identifier}/shorts
  • List profile livestreamsGET /v1/youtube/profiles/{identifier}/livestreams
  • List profile playlistsGET /v1/youtube/profiles/{identifier}/playlists
  • List profile community postsGET /v1/youtube/profiles/{identifier}/community-posts
  • Search profile videosGET /v1/youtube/profiles/{identifier}/search
  • List profile productsGET /v1/youtube/profiles/{identifier}/products

Posts

9 operations
  • Get a postGET /v1/youtube/posts/{identifier}
  • List post commentsGET /v1/youtube/posts/{identifier}/comments
  • List comment repliesGET /v1/youtube/posts/{identifier}/comments/{comment_id}/replies
  • Get a transcriptGET /v1/youtube/posts/{identifier}/transcript
  • Get post filesGET /v1/youtube/posts/{identifier}/files
  • Get post storyboardGET /v1/youtube/posts/{identifier}/storyboard
  • Get post frameGET /v1/youtube/posts/{identifier}/frame
  • List related postsGET /v1/youtube/posts/{identifier}/related
  • List posts using the same soundGET /v1/youtube/posts/{identifier}/sound-posts

Community posts

2 operations
  • Get a community postGET /v1/youtube/community-posts/{identifier}
  • List community post commentsGET /v1/youtube/community-posts/{identifier}/comments

Playlists

1 operation
  • List playlist postsGET /v1/youtube/playlists/{identifier}/posts

Hashtags

1 operation
  • List hashtag postsGET /v1/youtube/hashtags/{identifier}/posts

Search

4 operations
  • Search postsGET /v1/youtube/search/posts
  • Search profilesGET /v1/youtube/search/profiles
  • Search playlistsGET /v1/youtube/search/playlists
  • Search suggestionsGET /v1/youtube/search/suggestions

Trending

1 operation
  • List trending postsGET /v1/youtube/trending/posts

Charts

3 operations
  • List top music videosGET /v1/youtube/charts/videos
  • List top songsGET /v1/youtube/charts/tracks
  • List top artistsGET /v1/youtube/charts/artists

Lists carry rounded counts and estimated days. The single post endpoint returns exact values.

Built for
  • Creator research
  • Transcript and caption analysis
  • Comment monitoring
  • Music trend tracking
Known boundaries
  • Public content only.
  • Lists show the rounded counts and relative dates YouTube shows. The single video endpoint returns exact values.
  • YouTube rounds subscriber counts everywhere.

FAQ

YouTube questions.

Do I need a YouTube Data API key or quota?
No. Your application uses an Openhandle API key. There is no daily quota to manage.
Can I get the transcript of a video?
Yes. The transcript endpoint returns timed caption text in any caption language the video offers.
Why are some counts marked approximate?
YouTube shows labels like "152M views" in lists. Openhandle keeps that number and sets isApproximate to true. Read the video for the exact count.

Let your agent wire up YouTube.

Copy one prompt. It has the docs, the spec, and an example request. Your agent reads it and builds against your test key.

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents
Get started for $0Read the quickstart

100 free requests. No card needed.