YouTube

Channel

A channel's details: name, handle, description, subscribers, videos, views, country and links.

GET/v1/youtube/channel1 credit

Headers

Get your API key

x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

handlestringoptionalquery

A channel's handle, with or without the @. Give one of handle, channel_id or url.

example: MrBeast

channel_idstringoptionalquery

A channel's id: UC and 22 characters. Give one of handle, channel_id or url.

urlstringoptionalquery

A channel's link: youtube.com/@handle, /channel/<id>, /c/<name> or /user/<name>, with any tab after it. Give one of handle, channel_id or url.

max 300 chars

Response fields

dataobject

The result: one object, or a list for the endpoints that return several.

data.idstring

The channel's id: UC and 22 characters.

data.urlstring

The channel's link.

data.handlestringnullable

Its handle, without the @.

data.namestringnullable

Its name.

data.descriptionstringnullable

Its description.

data.avatarstringnullable

Its profile picture's link.

data.bannerstringnullable

Its banner image's link.

data.verifiedbooleanoptional

Whether YouTube shows it as verified.

default: false

data.countrystringnullable

The country it lists, by name ("United States").

data.created_atstringnullable

The day it joined YouTube.

format: date

data.subscribersintegernullable

Subscribers, as YouTube rounds them (522M is 522000000).

data.video_countintegernullable

How many videos it has.

data.viewsintegernullable

Its videos' views in all, exact.

data.linksstring[]nullable

The links on its About page.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether 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/channel?handle=MrBeast' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "url": "string",    "handle": "string",    "name": "string",    "description": "string",    "avatar": "string",    "banner": "string",    "verified": false,    "country": "string",    "created_at": "2019-08-24",    "subscribers": 0,    "video_count": 0,    "views": 0,    "links": [      "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  }}

Space

A Space, X's live audio: its title, state, hosts and speakers, listeners, times and whether it can be replayed.

Channel videos

A channel's videos, 30 a page: the latest first, the most viewed first, or the oldest first.