Video
A video's details: description, likes, comment count, chapters, captions, keywords and related videos.
GET/v1/youtube/videos1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
2video_idstringoptionalqueryA video's id: the 11 characters after watch?v= or /shorts/ in its link. Give video_id or url.
example: rfscVS0vtbw
urlstringoptionalqueryA video's link: watch?v=<id>, youtu.be/<id>, or a /shorts/, /live/, /embed/ or /v/ link, on youtube.com, www., m. or music. Give video_id or url.
max 300 chars
Response fields
53dataobjectThe result: one object, or a list for the endpoints that return several.
data.idstringThe video's id: 11 characters.
data.urlstringThe video's link.
data.titlestringnullableIts title.
data.is_shortbooleannullableWhether it is a short. Search, which mixes both, and the video endpoint set it; elsewhere it is null.
data.thumbnailstringnullableIts thumbnail's link.
data.duration_secondsintegernullableIts length, in seconds.
data.viewsintegernullableViews: exact where YouTube shows the exact number, else YouTube's rounding (12M is 12000000).
data.publishedstringnullableHow long ago it was published, as YouTube words it: "4h ago" in some lists, "14 years ago" in others.
data.channel_idstringnullableIts channel's id.
data.channel_namestringnullableIts channel's name.
data.channel_handlestringnullableIts channel's handle, without the @.
data.badgesstring[]nullableYouTube's labels on it, such as "New", "4K" or "CC".
data.descriptionstringnullableIts description: the start of it in search results, all of it from the video endpoint.
data.created_atstringnullableWhen it was published.
format: date-time
data.categorystringnullableIts category, such as "Entertainment".
data.keywordsstring[]nullableThe tags its uploader gave it.
data.likesintegernullableLikes.
data.comment_countintegernullableComments.
data.is_livebooleannullableWhether it is a live stream, now or past.
data.channel_subscribersintegernullableIts channel's subscribers, as YouTube rounds them.
data.captionsarraynullableIts caption tracks.
data.captions[].languagestringIts language code, such as "en" or "fr-FR".
data.captions[].namestringnullableIts name as YouTube shows it, such as "English (auto-generated)".
data.captions[].autobooleanoptionalWhether YouTube made it automatically.
default: false
data.chaptersarraynullableIts chapters, in order.
data.chapters[].titlestringThe chapter's title.
data.chapters[].start_secondsintegerWhere it starts, in seconds.
data.relatedarraynullableThe videos YouTube suggests next to it.
data.related[].idstringThe video's id: 11 characters.
data.related[].urlstringThe video's link.
data.related[].titlestringnullableIts title.
data.related[].is_shortbooleannullableWhether it is a short. Search, which mixes both, and the video endpoint set it; elsewhere it is null.
data.related[].thumbnailstringnullableIts thumbnail's link.
data.related[].duration_secondsintegernullableIts length, in seconds.
data.related[].viewsintegernullableViews: exact where YouTube shows the exact number, else YouTube's rounding (12M is 12000000).
data.related[].publishedstringnullableHow long ago it was published, as YouTube words it: "4h ago" in some lists, "14 years ago" in others.
data.related[].channel_idstringnullableIts channel's id.
data.related[].channel_namestringnullableIts channel's name.
data.related[].channel_handlestringnullableIts channel's handle, without the @.
data.related[].badgesstring[]nullableYouTube's labels on it, such as "New", "4K" or "CC".
data.related[].descriptionstringnullableIts description: the start of it in search results, all of it from the video endpoint.
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether it came from our cache; fetched_at says how old it is.
default: false
Code example
curl -X GET 'https://api.socialparse.dev/v1/youtube/videos?video_id=rfscVS0vtbw' \ -H 'x-api-key: YOUR_API_KEY'Responses
Successful Response
{ "data": { "id": "string", "url": "string", "title": "string", "is_short": true, "thumbnail": "string", "duration_seconds": 0, "views": 0, "published": "string", "channel_id": "string", "channel_name": "string", "channel_handle": "string", "badges": [ "string" ], "description": "string", "created_at": "2019-08-24T14:15:22Z", "category": "string", "keywords": [ "string" ], "likes": 0, "comment_count": 0, "is_live": true, "channel_subscribers": 0, "captions": [ { "language": "string", "name": "string", "auto": false } ], "chapters": [ { "title": "string", "start_seconds": 0 } ], "related": [ { "id": "string", "url": "string", "title": "string", "is_short": true, "thumbnail": "string", "duration_seconds": 0, "views": 0, "published": "string", "channel_id": "string", "channel_name": "string", "channel_handle": "string", "badges": [ "string" ], "description": "string" } ] }, "page": { "next_cursor": "string", "has_more": false }, "meta": { "platform": "string", "endpoint": "string", "params": { "property1": "string", "property2": "string" }, "request_id": "string", "api_version": "string", "fetched_at": "2019-08-24T14:15:22Z", "cached": false }}