Get YouTube channel
Looks up a YouTube channel by `channelId`, `handle`, or full `url`.
Operation
/v1/youtube/channelHeaders
API key (`sfk_...`)
Parameters
Optional YouTube channel id for the request.
min 1 chars · max 4096 chars
Optional YouTube channel handle for the request.
min 1 chars · max 64 chars
Optional YouTube channel URL for the request.
min 1 chars · max 4096 chars
Response fields
Endpoint-specific response payload.
Whether the channel was found or not found.
one of: found, not_found
Channel details when available.
Social platform for this channel.
one of: youtube
YouTube channel handle without the leading @.
Public display name for the YouTube channel.
Channel description text when available.
Best available square avatar image URL.
Channel banner image URL when available.
Whether the channel is marked as verified.
Canonical public YouTube channel URL.
min 1 chars
YouTube channel id (stable identifier for the channel).
Country label when available.
Human-readable join date text from YouTube when available (not guaranteed to parse to a calendar date).
Deduplicated outbound links associated with the channel when available.
min 1 chars
Channel metrics when available.
Subscriber count for the channel when available.
≥ 0
Public video count for the channel when available.
≥ 0
Total view count reported for the channel when available.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.
Error codes
Post or article
Returns public metadata for a single LinkedIn feed post or article. Availability is indicated in `data.lookupStatus` as `found` or `not_found`.
Channel videos
Lists videos for a YouTube channel. Pass `channelId` or `handle` to identify the channel. Optional query `sortBy` controls ordering, `cursor` continues from `data.page.nextCursor`, and `includeExtras=true` may add richer per-video metadata when available. An empty `data.videos` array can still accompany `data.lookupStatus: "found"` when the channel resolves but no videos are returned for the current page.