YouTube API · Video Detail

Video Detail

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

Send a video id and get back the core snippet and statistics most YouTube tools are built on. Use this when you already have the id; to find videos by keyword, start with Video Search. An unresolvable id returns null (still a billable 200). Ideal for video dashboards, monitoring and enrichment jobs.

POST /api/v1/video/detail $0.003 / request

Get API Key Open Playground

Use your Tubefield API key instantly, or inspect the sample response first.

curl

curl -X POST https://tubefield.com/api/v1/video/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $TUBEFIELD_API_KEY" \
  -d '{"video_id": "dQw4w9WgXcQ"}'

Sample response

{
  "target": "dQw4w9WgXcQ",
  "video": {
    "channel": "Rick Astley",
    "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "comments": 2300000,
    "duration": "PT3M33S",
    "likes": 17000000,
    "published_at": "2009-10-25T06:57:33Z",
    "tags": [
      "rick astley",
      "never gonna give you up"
    ],
    "title": "Rick Astley - Never Gonna Give You Up",
    "video_id": "dQw4w9WgXcQ",
    "views": 1500000000
  }
}

API Playground

Run a real /api/v1/video/detail request. No key? We show the real sample result so you can still inspect the shape.

Endpoint

POST /api/v1/video/detail

sample mode

Auth header X-API-Key

Cost $0.003 / request

API key

Leave empty to inspect the response shape without spending API balance.

JSON body

Sample mode: explore the real response shape for free. Add a key to run a live request.

Response

POST /api/v1/video/detail

sample

{
  "target": "dQw4w9WgXcQ",
  "video": {
    "channel": "Rick Astley",
    "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "comments": 2300000,
    "duration": "PT3M33S",
    "likes": 17000000,
    "published_at": "2009-10-25T06:57:33Z",
    "tags": [
      "rick astley",
      "never gonna give you up"
    ],
    "title": "Rick Astley - Never Gonna Give You Up",
    "video_id": "dQw4w9WgXcQ",
    "views": 1500000000
  }
}

Request and response

The full contract for /api/v1/video/detail: what to send and what comes back.

Request body

video_id string required

The 11-character YouTube video id.

Response fields

Field	Type	Description
`video`	object \| null	Video object, or null when the id doesn't resolve (still a billable 200).
`video.title`	string	Video title.
`video.channel`	string	Channel title.
`video.channel_id`	string	Canonical channel id (UC…).
`video.published_at`	string	Publish timestamp (ISO 8601).
`video.duration`	string \| null	ISO 8601 duration, e.g. PT3M33S.
`video.views`	integer \| null	Total view count.
`video.likes`	integer \| null	Like count when public.
`video.comments`	integer \| null	Comment count when enabled.
`video.tags`	string[]	Uploader tags, possibly empty.

Code examples

Copy, paste, swap in your API key.

curl -X POST https://tubefield.com/api/v1/video/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: " \
  -d '{"video_id": "dQw4w9WgXcQ"}'

import requests

resp = requests.post(
    "https://tubefield.com/api/v1/video/detail",
    headers={"X-API-Key": ""},
    json={"video_id": "dQw4w9WgXcQ"},
)
print(resp.json())

const resp = await fetch("https://tubefield.com/api/v1/video/detail", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "",
  },
  body: JSON.stringify({"video_id": "dQw4w9WgXcQ"}),
});
console.log(await resp.json());

What developers build with it

Common ways Video Detail ends up in production.

Video performance dashboards and monitoring.

Enriching crawled or user-submitted video links.

Competitive content research at the video level.

Status codes

The same predictable contract on every endpoint.

`200`	Success. The lookup completed and was charged, even if the response is empty.
`401`	Missing or unknown API key.
`402`	Not enough balance on the account.
`422`	Invalid request body (wrong shape or types).
`429`	Rate limit exceeded: max 10 requests per second per API key.

Other endpoints

Explore the rest of the YouTube API.

Video Comments

/api/v1/video/comments

Video Transcript

/api/v1/video/transcript

Channel Detail

/api/v1/channel/detail

Channel Videos

/api/v1/channel/videos

Channel Playlists

/api/v1/channel/playlists

Channel Lookup

/api/v1/channel/lookup

Playlist Detail

/api/v1/playlist/detail

Playlist Videos

/api/v1/playlist/videos

Video Search

/api/v1/search/videos

Search Result (SERP)

/api/v1/search/result

Account Balance

/api/v1/account/balance

View all endpoints

Pay once. Spend when needed.

New accounts start with a free API balance. Paid balance never expires, so it can sit until your workflows need it.

Free

$0.50 free

$0.50 free balance to start. About 150 standard requests. Get an API key in seconds with no credit card.

Access all endpoints
No credit card required
Good for first tests

Create free account

Starter

$10 one-time

Adds $10 to your API balance for steady production traffic and early automated jobs.

Balance never expires
Fixed per-request pricing
Useful for small pipelines

Get started

Pro Most popular

$100 one-time

$130 spendable balance, including a $30 bonus. The sweet spot for production workloads.

$100 + $30 free balance
Best value per workload
Built for automated pipelines

Get started

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