YouTube Scraper
Get YouTube Video Sponsors
Experimental endpoint. Checks a YouTube video for the paid-promotion disclosure and infers likely sponsors/promoted brands from the public description, description links, promo-code text, and transcript. YouTube tells us that a video contains paid promotion, but it does not always tell us the sponsor directly, so this endpoint returns suspected sponsors with confidence and evidence. This is inferred, not an official YouTube sponsor field.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| urlstring · required | string | required | YouTube video or short URL |
| limitnumber · optional | number | optional | Maximum number of results to return from this request. Leave empty for everything this request returns. This trims the response — it does not fetch more. The price is the same either way. |
| languagestring · optional | string | optional | 2 letter language code used for transcript lookup, ie 'en', 'es', 'fr' etc. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"video": {
"type": "object",
"additionalProperties": {}
},
"limitApplied": {
"type": "boolean",
"description": "True when a Limit trimmed the results; there were more in this response."
},
"sponsorDetection": {
"type": "object",
"additionalProperties": {}
},
"suspectedSponsors": {
"type": "array"
}
},
"additionalProperties": true
}