YouTube Channel API

Look up a public YouTube channel and inspect its returned details and metrics.

GET/v1/youtube/channel

1 credit per successful callCache window 30 minutesFull API reference ↗

Coverage is rolling out during preview. Test the endpoint you need before integrating. Unavailable operations return an explicit error and use no credits.

Try this endpoint

Enter the documented inputs, run a protected browser test, and inspect the JSON response.

Request preview

Copy this request into your server-side integration, or run a test to inspect the response.

curl -X GET 'https://socialquery.dev/v1/youtube/channel?channelId=UC_x5XG1OV2P6uZZ5FSM9Ttw' \
  -H "x-api-key: $SOCIALQUERY_API_KEY"

Request contract

Parameters

Pass these fields as query parameters. Production requests also require your server-side API key.

Choose one: channelId or handle or url

channelIdOptional: The YouTube channel ID. Use this, a handle, or a channel URL.
Example: UC_x5XG1OV2P6uZZ5FSM9Ttw
handleOptional: The public account handle, in the format shown in the example.
Example: MrBeast
urlOptional: The public URL of the resource you want to look up.
Example: https://www.youtube.com/@GoogleDevelopers
hlOptional: The language code for the request, where supported.
Example: en
forUsernameOptional: A legacy YouTube username, where supported by the endpoint.
Example: GoogleDevelopers
contact_emailOptional: Optional contact-email lookup flag. Availability depends on the source.
Example: 1