Use case, YouTube video search

YouTube video search API for your agent. One call per search.

Send a keyword. Read video title and link back. Your agent picks the provider, and you pay per call.

Give this to your agent
set up looot for YouTube video search API - https://looot.ai/use-cases/youtube-video-search-api/skill.md

The short answer

The short answer

YouTube video search API for an agent: it sends a keyword to a catalog endpoint and reads video title, link and view count back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

Updated

  • Video title and link
  • View count
  • Publish date
  • Duration
  • Channel

The job

What the YouTube video search API gives your agent

A YouTube search shows what people watch for a topic. Your agent sends a keyword and reads back the videos with their views, dates, durations and channels. It tells you which angles are crowded, which are old and which channels own a topic.

One provider returns videos, channels, playlists, Shorts and live streams in one search, with filters for upload date, duration and sort order. Another focuses on videos and takes a country and a language code. A third returns the organic YouTube results as live tasks, in the format of an SEO data provider.

You give

a keyword

home espresso setup

You get

  • Video title and link
  • View count
  • Publish date
  • Duration
  • Channel

Providers, cheapest first

What actually differs between providers

Today the price runs from $0.0010 to $0.0020 across 3 endpoints. The dearest costs about 2.0 times the cheapest. Price is only one difference. Each entry below says what that endpoint takes or returns that the others do not.

  1. TikHub logoTikHub

    Searches videos with an order, a country code and a language code, and pages with a token.

    tikhub-api-youtube-web-search-video
    $0.0010 / call
  2. ScrapeCreators logoScrapeCreators

    Returns videos, channels, playlists, Shorts, shelves and live streams, with filters for upload date, duration, type and sort order.

    scrapecreators-youtube-search
    $0.00188 / call
  3. DataForSEO logoDataForSEO

    Returns YouTube video search results live, as a task array.

    dataforseo-youtube-organic-advanced
    $0.0020 / call

Cost

What 100 YouTube video search runs cost

$0.1000

100 searches cost about $0.1000 through the cheapest endpoint, at TikHub, and about $0.2000 through the dearest. Each run is one call.

Sample calls

The request and what comes back

Each run is one POST to /v1/runs with an endpoint id and an input. These are illustrative calls with generic values. The run's result holds the provider's own fields.

Request
{"endpointId":"scrapecreators-youtube-search","input":{"query":"home espresso setup"},"wait":30}
ResponseSample output
// POST /v1/runs, then read run.status and run.result
// result: returns videos, channels, playlists, Shorts, shelves and live streams, with filters for upload date, duration, type and sort order

The prompt

Copy one prompt, give it to your agent.

Edit the names and numbers, paste it, and the agent runs the job and shows the cost.

  • One run is one search.
  • 1 step across 3 providers.
  • Runs on demand, whenever you ask.
Prompt: YouTube video search API
Use looot to search YouTube for home espresso setup and return the title, channel, views, publish date and duration of the top results, newest and most viewed first. 1. Set up https://looot.ai/skill.md. 2. Search the catalog for each step and check its price before you call. 3. Run the cheapest endpoint that fits. 4. Show the results as a table and the total cost.

Give this to your agent
Setup command
set up looot for YouTube video search API - https://looot.ai/use-cases/youtube-video-search-api/skill.md

Before you start

Settle these before the first run

  • Say which result type you want. A broad search returns videos, channels and playlists together, and filtering to videos keeps the list clean.
  • Set the upload window. Old videos with a million views and new ones with ten thousand answer different questions.
  • Set the country and language on providers that take them. Results differ by market.

FAQ

Questions people ask

Which angles are crowded, which videos are old but still rank and which channels own a topic. Your agent can sort by views per day since upload to find the videos that outperform.

The first provider returns Shorts in its results, and the catalog has an endpoint that searches Shorts only. Ask your agent to look it up and show the price first.

Send the keyword to a YouTube search endpoint. Your agent reads the videos back with the title, channel, views and date. Add filters for upload date or duration to narrow the list.

Yes. The first provider's search returns channels as well as videos, and another endpoint in the catalog searches channels only. See the creator search page.

Yes, on the provider that supports it. You can restrict a search to recent uploads, which is the filter that matters most for trend work.

A page of results, with a token to fetch the next one. Your agent pages until it has the number you asked for, and each page is billed as a call.

You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable.

No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider.

No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs.

Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/<runId>.

That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results.

No. looot bills per call, and nothing runs while your agent is idle.

More ways to run this job

For agents
use case
YouTube video search API
run
search
schedule
on demand
step
Search YouTube: scrapecreators tikhub dataforseo
setup
https://looot.ai/use-cases/youtube-video-search-api/skill.md
llms.txt
https://looot.ai/llms.txt
updated
2026-10-04

Try YouTube video search with your own agent.

Start your workspace, top up, and paste the prompt into the agent you already use.