YouTube data

YouTube Video Details Scraper (bulk, lightweight)

Full metadata for up to 500 YouTube videos per run: title, description, view count, duration, publish date, category, tags, channel and thumbnail. Paste URLs, short links, shorts or bare video ids. Only delivered videos are charged.

$1.50per 1,000 · Video delivered

One video with full metadata delivered to the dataset. Videos that fail, are deleted or are private are never charged.

Call it from your code

curl
ACTOR=steadydata~youtube-video-details
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 '{"videos": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ", "JGwWNGJdvx8"], "language": "en", "country": "US"}'
python
import os, requests

ACTOR = "steadydata~youtube-video-details"
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={'videos': ['https://www.youtube.com/watch?v=dQw4w9WgXcQ', 'JGwWNGJdvx8'], 'language': 'en', 'country': 'US'},
    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-video-details";
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({"videos": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ", "JGwWNGJdvx8"], "language": "en", "country": "US"}),
}).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-video-details

# the tool arrives in your agent as steadydata--youtube-video-details

Input

FieldTypeNameWhat it does
videos
required
array of stringVideosVideo URLs or ids, up to 500 per run. Watch URLs, youtu.be links, shorts, embeds and bare 11-character ids all work.
languagestringLanguageInterface language for the texts YouTube returns, e.g. en, nl, de.
countrystringCountryISO country code used for the request, e.g. US, NL, DE. Some videos are region restricted.

What you get back

output schema, one object per delivered row
{
  "videoId": string | null,
  "url": string | null,
  "title": string | null,
  "description": string | null,
  "channelId": string | null,
  "channelName": string | null,
  "channelUrl": string | null,
  "viewCount": integer | null,
  "durationSeconds": integer | null,
  "publishDate": string | null,
  "uploadDate": string | null,
  "category": string | null,
  "tags": array | null,
  "isLiveContent": boolean | null,
  "isFamilySafe": boolean | null,
  "thumbnailUrl": string | null,
  "status": string | null,
  "input": string | null,
  "errorCode": string | null,
  "error": string | null
}
FieldTypeWhen it is filled
videoIdstring, null
urlstring, null
titlestring, null
descriptionstring, null
channelIdstring, null
channelNamestring, null
channelUrlstring, null
viewCountinteger, null
durationSecondsinteger, null
publishDatestring, null
uploadDatestring, null
categorystring, null
tagsarray, null
isLiveContentboolean, null
isFamilySafeboolean, 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