Get YouTube video sponsors

Get a YouTube video's paid promotion flag and its likely sponsors by URL.

GET/v1/youtube/videos/sponsors
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
urlstringrequiredquery

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

languagestringoptionalquery

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})*$

Response fields
28

Endpoint-specific response payload.

datalookupStatus
string

Whether the video was found.

one of: found, not_found

The video that was checked; null when not found.

datavideoid
string

YouTube video identifier.

min 1 chars

datavideourl
string

Public YouTube watch URL for the video.

min 1 chars

datavideotitle
stringnullable

Video title when available.

datavideoisPaidPromotion
booleannullable

Whether YouTube shows the video's paid promotion disclosure. This is YouTube's own flag; null when unknown.

The uploading channel when available.

datavideochannelplatform
string

Social platform for this channel.

one of: youtube

datavideochannelplatformUserId
stringnullable

YouTube channel id when available.

datavideochannelhandle
stringnullable

YouTube channel handle without the leading @, when available.

datavideochanneldisplayName
stringnullable

Public display name of the channel when available.

datavideochannelprofileUrl
stringnullable

Public YouTube channel URL when available.

datavideochannelavatarUrl
stringnullable

Channel avatar image URL when available.

Suspected sponsors, strongest first. Empty when no sponsor was found.

datasponsors[]name
string

Name of the suspected sponsor or brand.

min 1 chars

datasponsors[]website
stringnullable

The sponsor's website domain when one was found.

datasponsors[]confidence
stringnullable

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.

datasponsors[]evidence[]source
stringnullable

Where the evidence was found, such as `description`, `description_link` or `transcript`.

datasponsors[]evidence[]text
stringnullable

The passage that mentions the sponsor, when available.

datatranscriptChecked
booleannullable

Whether the video's captions were read for spoken sponsor mentions; null when unknown.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.