Headers
Get your API keyAPI key (`sfk_...`)
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
Endpoint-specific response payload.
Whether the channel was 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
curl "https://api.socialfetch.dev/v1/youtube/channel?url=https://www.youtube.com/@MrBeast" \
-H "x-api-key: YOUR_API_KEY"Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.