Start For Free

The YouTube data layer

Twelve tools your agent can call.

Every endpoint links to full docs and a live playground. Search by use case, resource type, path, field name, or pricing.

12 endpoints shown

Video Detail

/api/v1/video/detail

Title, channel, duration, views, likes, comment count and tags for a single video in one call.

video $0.003 / request

Video Comments

/api/v1/video/comments

Top comments by relevance for any video: author, text, likes and timestamp, up to 1000 per call.

video $0.003 / request

Video Transcript

/api/v1/video/transcript

The full transcript of any video as timestamped plain text, in a single call.

video $0.003 / request

Channel Detail

/api/v1/channel/detail

Title, description, country, subscribers, total views and video count for a single channel.

channel $0.003 / request

Channel Videos

/api/v1/channel/videos

A channel's latest uploads: up to 1000 per call, without burning expensive search quota.

channel $0.003 / request

Channel Playlists

/api/v1/channel/playlists

All public playlists of a channel with title, size and creation date.

channel $0.003 / request

Channel Lookup

/api/v1/channel/lookup

Resolve a channel handle ⇄ id. YouTube hides the channel id, so turn the @handle you have into the id the API needs.

Playlist Detail

/api/v1/playlist/detail

Title, owner, description and item count for a single playlist.

playlist $0.003 / request

Playlist Videos

/api/v1/playlist/videos

Every video in a playlist with title, owner and position: up to 1000 per call.

playlist $0.003 / request

Video Search

/api/v1/search/videos

Global YouTube video search with optional country and language bias: up to 50 results per call.

search $0.01 / request

Search Result (SERP)

/api/v1/search/result

One call returns the top videos for a keyword, each enriched with full detail and transcript: 1–10 results.

search $0.01 search + $0.003 detail + $0.003 transcript

Account Balance

/api/v1/account/balance

Check the remaining prepaid balance on the account behind the API key, in credits and dollars.

FAQ

Questions before you connect?

Pricing & Balance

Every endpoint has a fixed per-request price in USD, shown on its docs page, and charged against your API balance, so you always know what each call costs.

YouTube charges far more underlying quota for search than for direct lookups. Video Search costs $0.01 / request; every other endpoint costs $0.003 / request.

No. Your API balance never expires, so you can use it whenever your workflows need it. In the unlikely event TubeField is ever discontinued, unused paid balance is refunded.

Paid API requests stop with a 402 until you add more balance. This keeps spend predictable and prevents unexpected charges.

API & Integration

Create and manage API keys from your account, then send your key in the X-API-Key header from your app, scripts, or internal tools.

Yes. Your dashboard shows every request, its cost, and your remaining balance, so you can track spend while building and running automated workflows.

Yes, a completed lookup is billable even when the answer is empty (for example a video with comments turned off). Errors like 402 or 429 are never charged.

We enforce a rate limit of 10 requests per second per API key. If you exceed it, the API returns HTTP 429. Build exponential backoff (briefly pausing before retrying) into your application code.

Our support team responds to email inquiries within 1 business day. We can help with account, billing, and API integration questions.

Give your product and agents YouTube data.

Start with a free key and about 150 free requests, on REST, MCP, or both.

Integrate YouTube Data