Get YouTube video sponsors
Get a YouTube video's paid promotion flag and its likely sponsors by URL.
Headers
Get your API keyAPI key (`sfk_...`)
Link to the YouTube video to check, such as `https://www.youtube.com/watch?v=AVO0ifle-OU`, or its 11-character id. Shorts URLs are also supported.
min 1 chars · max 4096 chars
Language code of the captions to read for spoken sponsor mentions, such as `en` or `es`.
pattern: ^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$
Endpoint-specific response payload.
Whether the video was found.
one of: found, not_found
The video that was checked; null when not found.
YouTube video identifier.
min 1 chars
Public YouTube watch URL for the video.
min 1 chars
Video title when available.
Whether YouTube shows the video's paid promotion disclosure. This is YouTube's own flag; null when unknown.
The uploading channel when available.
Social platform for this channel.
one of: youtube
YouTube channel id when available.
YouTube channel handle without the leading @, when available.
Public display name of the channel when available.
Public YouTube channel URL when available.
Channel avatar image URL when available.
Suspected sponsors, strongest first. Empty when no sponsor was found.
Name of the suspected sponsor or brand.
min 1 chars
The sponsor's website domain when one was found.
How strongly the evidence points to a sponsorship: `high` when the text calls it a sponsor, `medium` for a partner tag, promo code or discount, `low` for little more than a link. Inferred, so check the evidence. Null when not rated.
one of: high, medium, low, null
Passages from the video that point to this sponsor.
Where the evidence was found, such as `description`, `description_link` or `transcript`.
The passage that mentions the sponsor, when available.
Whether the video's captions were read for spoken sponsor mentions; null when unknown.
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
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/youtube/videos/sponsors?url=https://www.youtube.com/watch?v=AVO0ifle-OU" \
-H "x-api-key: YOUR_API_KEY"Responses
Suspected YouTube video sponsors.