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.

get/v1/youtube/channel

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/youtube/channel
  • Auth: API key in header x-api-key

Query parameters

channelIdstring

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

handlestring
Example:MrBeast

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

urlstring

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

hlstring

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

forUsernamestring

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.

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.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.