YouTube Video Sponsors API
Brands, promo codes and affiliate links inferred from a video's description, plus YouTube's own paid-promotion disclosure. Every signal carries the description line it was read from and a confidence, because this is inference over prose. YouTube publishes no structured sponsor data. Experimental: expect to check evidence before acting on low confidence. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.
Try it
Prefilled with the request that produced the example below. No key yet? Get a free key.
Request
/v1/youtube/video/sponsors| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | Video URL or 11-character video id |
Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).
curl "$API/v1/youtube/video/sponsors?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D0e3GPea1Tyg&cache_max_age=7d" \
-H "x-api-key: $KEY"const query = new URLSearchParams({
url: 'https://www.youtube.com/watch?v=0e3GPea1Tyg',
cache_max_age: '7d',
});
const response = await fetch(`${API}/v1/youtube/video/sponsors?${query}`, {
headers: { 'x-api-key': KEY },
});
const body = await response.json();
if (!body.success) throw new Error(body.error.code);
// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);import os, httpx
r = httpx.get(
f"{os.environ['API']}/v1/youtube/video/sponsors",
params={
"url": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
"cache_max_age": "7d",
},
headers={"x-api-key": os.environ["KEY"]},
timeout=30,
)
body = r.json()
if not body["success"]:
raise RuntimeError(body["error"]["code"])
print(body["data"], body["meta"]["creditsCharged"])Example response
Captured on , with raw removed and lists cut to two items. A live call returns current data.
{
"success": true,
"data": {
"postId": "0e3GPea1Tyg",
"url": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
"title": "$456,000 Squid Game In Real Life!",
"disclosedPaidPromotion": false,
"sponsors": [
{
"name": "Extrememusic",
"domain": "extrememusic.com",
"url": "https://www.extrememusic.com/",
"promoCode": null,
"discount": null,
"kind": "gifted",
"confidence": "medium",
"evidence": "Music Provided by https://www.extrememusic.com/"
}
],
"promoCodes": [],
"outboundLinks": [
"https://www.beastgames.com",
"https://prf.hn/l/6bNbQB3"
],
"fetchedAt": "2026-10-21T01:55:48.141Z"
},
"meta": {
"platform": "youtube",
"endpoint": "youtube.videoSponsors",
"creditsCharged": 1,
"cached": false,
"cacheAgeSeconds": null,
"durationMs": 2312,
"requestId": "req_h4l6fkvt4je1jvl8wrlq"
}
}Returns
Returns an object with postId, url, title, disclosedPaidPromotion, sponsors, promoCodes, outboundLinks, fetchedAt.
Fields
| Field | Type | Present |
|---|---|---|
| postId | string | always |
| url | string | always |
| title | string | always |
| disclosedPaidPromotion | boolean | always |
| sponsors | object[] | always |
| sponsors[].name | string | null | always |
| sponsors[].domain | string | null | always |
| sponsors[].url | string | null | always |
| sponsors[].promoCode | string | null | always |
| sponsors[].discount | string | null | always |
| sponsors[].kind | sponsor | affiliate | gifted | always |
| sponsors[].confidence | high | medium | low | always |
| sponsors[].evidence | string | always |
| promoCodes | string[] | always |
| outboundLinks | string[] | always |
| fetchedAt | string | always |
Cost and behaviour
| Credits | 1 per live request, 0 on a cache hit |
| Cacheable | yes: cache_max_age accepts a cached copy |
| Batchable | yes: usable as a target in POST /v1/jobs/batch |
| Subscribable | yes: as often as every 3600 seconds, firing a webhook only on a change |
Other YouTube endpoints
- /v1/youtube/channel Channel details
- /v1/youtube/channel-videos Channel videos
- /v1/youtube/channel/community-posts Channel community posts
- /v1/youtube/channel/lives Channel live streams
- /v1/youtube/channel/playlists Channel playlists
- /v1/youtube/channel/shorts Channel shorts
- /v1/youtube/community-post Community post details
- /v1/youtube/playlist Playlist contents