YouTube data

YouTube Search Results Scraper (bulk keywords, lightweight)

Ranked YouTube search results for up to 200 keywords per run: rank, title, video id, duration, view count, publish date and thumbnail. Sort by relevance, date, views or rating. Only delivered results are charged.

$0.40per 1,000 · Result listed

One search result delivered to the dataset. Keywords that fail or return nothing are never charged.

Call it from your code

curl
ACTOR=steadydata~youtube-search
URL="https://api.apify.com/v2/acts/$ACTOR/run-sync-get-dataset-items"

curl -X POST "$URL?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["web scraping tutorial"], "maxResultsPerQuery": 50, "sortBy": "relevance"}'
python
import os, requests

ACTOR = "steadydata~youtube-search"
URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items"

rows = requests.post(
    URL,
    params={"token": os.environ["APIFY_TOKEN"]},
    json={'queries': ['web scraping tutorial'], 'maxResultsPerQuery': 50, 'sortBy': 'relevance'},
    timeout=900,
).json()

# every row carries a status; failures are records, not exceptions
ok = [r for r in rows if r.get("status") == "ok"]
print(len(ok), "rows delivered")
javascript
const ACTOR = "steadydata~youtube-search";
const url =
  `https://api.apify.com/v2/acts/${ACTOR}/run-sync-get-dataset-items` +
  `?token=${process.env.APIFY_TOKEN}`;

const rows = await fetch(url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"queries": ["web scraping tutorial"], "maxResultsPerQuery": 50, "sortBy": "relevance"}),
}).then((r) => r.json());

// one object per delivered row, same shape every time
console.log(rows.filter((r) => r.status === "ok").length, "rows");

Use it in an agent

Point an MCP client at Apify's hosted server with this dataset in the tools list, or run our own server locally. The field explanations in the table below travel with the schema, so your agent reads them straight from the platform instead of from this page.

mcp url
https://mcp.apify.com?tools=steadydata/youtube-search

# the tool arrives in your agent as steadydata--youtube-search

Input

FieldTypeNameWhat it does
queries
required
array of stringSearch queriesKeywords to search YouTube for, up to 200 per run.
maxResultsPerQueryintegerMax results per queryStop after this many results per query. This is your cost ceiling: one delivered result is one charged event.
sortBystringSort byHow YouTube should order the results.
languagestringLanguageInterface language for the texts YouTube returns, e.g. en, nl, de.
countrystringCountryISO country code used for the request. Search results differ per country.

What you get back

output schema, one object per delivered row
{
  "query": string | null,
  "sortBy": string | null,
  "rank": integer | null,
  "videoId": string | null,
  "url": string | null,
  "title": string | null,
  "duration": string | null,
  "durationSeconds": integer | null,
  "viewCount": integer | null,
  "publishedText": string | null,
  "thumbnailUrl": string | null,
  "status": string | null,
  "input": string | null,
  "errorCode": string | null,
  "error": string | null
}
FieldTypeWhen it is filled
querystring, null
sortBystring, null
rankinteger, null
videoIdstring, null
urlstring, null
titlestring, null
durationstring, null
durationSecondsinteger, null
viewCountinteger, null
publishedTextstring, null
thumbnailUrlstring, null
statusstring, nullEither 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged.
inputstring, nullThe input this row was built from, so a row can always be traced back.
errorCodestring, nullFilled on an error row only; a delivered row leaves it empty.
errorstring, nullFilled on an error row only; a delivered row leaves it empty.

Related datasets

Already using this one? Ratings are the first thing other buyers look at, and this dataset has none yet. If it does a job for you, a rating on its Apify page is the one thing that helps. It takes a minute and it is the only thing we ask for.

Open the Apify page