InsightSocial API
YouTube

YouTube Channel API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/youtube/channel?handle=MrBeast" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Step-by-step: Get a YouTube channel's business email · Competitor tracking · Creator engagement scoring

GET
/v1/youtube/channel

Returns a YouTube channel's public profile: subscriber count on author.followers (rounded above 1,000), video and view totals, description, banner and avatar URLs, and author.ext.public_email.

Use it when you have a handle, channel id, or channel URL and want an account snapshot before pulling its videos.

10 credits per call.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

channelId?string

YouTube channel ID. Can pass a channelId, handle or url. Provide at least one of: channelId, handle, url.

handle?string

YouTube channel handle without the @ symbol. Provide at least one of: channelId, handle, url.

url?string

YouTube channel URL. Can pass a channelId, handle or url. Provide at least one of: channelId, handle, url.

hl?string

Preferred response language for localized text (ISO 639-1, e.g. 'en', 'es', 'fr').

forUsername?string

Legacy YouTube username (pre-handle) to look up.

contact_email?"1"

Optional. When 1, also returns author.ext.contact_email: when the bio lists two or more email addresses, the one the creator gives for contacting them personally, copied verbatim from the bio. Null when there is one address or none, when every address belongs to a manager, agency or brand, or when the choice was not confident. author.ext.public_email is unchanged. No extra credits.

Value in

  • "1"
dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/youtube/channel"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "author": {      "id": "string",      "username": "string",      "display_name": "string",      "avatar_url": "http://example.com",      "bio": "string",      "verified": true,      "followers": 0,      "followers_approximate": true,      "following": 0,      "posts_count": 0,      "likes_count": 0,      "url": "http://example.com",      "location": "string",      "external_url": "http://example.com",      "private": true,      "joined_at": "2019-08-24T14:15:22Z",      "last_post_at": "2019-08-24T14:15:22Z",      "ext": {        "property1": null,        "property2": null      }    }  }}

Channel › Videos GET

Returns recent videos published by a channel, each with title, view count, duration, thumbnail, and publish date; pass includeExtras=true to add like and comment counts.

Community Post GET

Returns one YouTube community post: its text, like count, comment count, attached images, and author info.