InsightSocial API
YouTube

Channel

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.

20 credits per call.

Re-running the exact same call within 24h is free.

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"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/youtube/channel"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

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. Use it for a channel's regular uploads; channel/shorts covers Shorts, channel/lives covers streams, channel/community-posts covers text posts. **Metered: 20–40 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).

Community Post GET

Returns one YouTube community post: its text, like count, comment count, attached images, and author info. Use it when you have a single community post URL; channel/community-posts lists them for a whole channel. **20 credits** per call. Re-running the exact same call within 6h is free.