YouTube API · Search Result (SERP)

Search Result (SERP)

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

Send a keyword and a result count (1–10). For each match you get its video detail and transcript in a single response: a ready-made SERP, saving you the follow-up Video Detail and Video Transcript calls. Billed as the search plus a detail and a transcript per result, and only for the results actually returned.

POST /api/v1/search/result $0.01 search + $0.003 detail + $0.003 transcript

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/search/result \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $TUBEFIELD_API_KEY" \
  -d '{"count": 3, "keyword": "bash scripting"}'

Sample response

{
  "keyword": "bash scripting",
  "results": [
    {
      "detail": {
        "channel": "Example Channel",
        "channel_id": "UCabc123def456ghi789jkl",
        "comments": 642,
        "duration": "PT12M30S",
        "likes": 15300,
        "published_at": "2026-03-20T12:00:00Z",
        "tags": [
          "bash",
          "scripting",
          "linux"
        ],
        "title": "Bash Scripting Tutorial for Beginners",
        "video_id": "abc123def45",
        "views": 482000
      },
      "transcript": {
        "available": true,
        "target": "abc123def45",
        "transcript": "00:00:00 In this tutorial we cover bash scripting\n00:00:05 starting with variables"
      },
      "video_id": "abc123def45"
    }
  ]
}

API Playground

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

Endpoint

POST /api/v1/search/result

sample mode

Auth header X-API-Key

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

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/search/result

sample

{
  "keyword": "bash scripting",
  "results": [
    {
      "detail": {
        "channel": "Example Channel",
        "channel_id": "UCabc123def456ghi789jkl",
        "comments": 642,
        "duration": "PT12M30S",
        "likes": 15300,
        "published_at": "2026-03-20T12:00:00Z",
        "tags": [
          "bash",
          "scripting",
          "linux"
        ],
        "title": "Bash Scripting Tutorial for Beginners",
        "video_id": "abc123def45",
        "views": 482000
      },
      "transcript": {
        "available": true,
        "target": "abc123def45",
        "transcript": "00:00:00 In this tutorial we cover bash scripting\n00:00:05 starting with variables"
      },
      "video_id": "abc123def45"
    }
  ]
}

Request and response

The full contract for /api/v1/search/result: what to send and what comes back.

Request body

keyword string required

Search phrase, 1–200 characters.

count integer optional

Number of enriched results, 1–10. Default 1.

country string optional

ISO 3166-1 alpha-2 region code, e.g. 'DE'.

language string optional

ISO 639-1 relevance language, e.g. 'de'.

Response fields

Field	Type	Description
`keyword`	string	The searched keyword, echoed back.
`results`	object[]	Enriched matches by relevance. Can be fewer than `count` (or empty) when the keyword has few matches.
`results[].video_id`	string	YouTube video id.
`results[].detail`	object \| null	Full video detail (same shape as /video/detail), or null when the id doesn't resolve.
`results[].transcript`	object	Transcript payload (same shape as /video/transcript): target, available, transcript.

Code examples

Copy, paste, swap in your API key.

curl -X POST https://tubefield.com/api/v1/search/result \
  -H "Content-Type: application/json" \
  -H "X-API-Key: " \
  -d '{"count": 3, "keyword": "bash scripting"}'

import requests

resp = requests.post(
    "https://tubefield.com/api/v1/search/result",
    headers={"X-API-Key": ""},
    json={"count": 3, "keyword": "bash scripting"},
)
print(resp.json())

const resp = await fetch("https://tubefield.com/api/v1/search/result", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "",
  },
  body: JSON.stringify({"count": 3, "keyword": "bash scripting"}),
});
console.log(await resp.json());

What developers build with it

Common ways Search Result (SERP) ends up in production.

Building keyword-to-content research dashboards.

Feeding ranked video sets with transcripts into LLM pipelines.

One-call competitive SERP analysis for a topic.

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 Detail

/api/v1/video/detail

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

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