/v1/youtube/video/sponsors
Video Sponsors
Experimental: infer possible video sponsors from public evidence, not an official YouTube sponsor field. Send feedback to support@Fetchproof.
| Credit cost | Default: 1 credit How charges are determinedCost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute. |
|---|---|
| Cache support | Not specified in the published contract. |
| Pagination | No explicit pagination metadata in the published contract. Consult the parameters and response fields below. |
Parameters
| Name | Location / required | Schema |
|---|---|---|
urlYouTube video or short URL | query / required |
|
languageTwo-letter language code for transcript lookup, such as en, es, or fr. | query / optional |
|
Request examples
Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.
cURL
curl --request GET 'https://api.fetchproof.com/v1/youtube/video/sponsors?url=YOUR_URL' \
--header 'x-api-key: YOUR_API_KEY'JavaScript
const response = await fetch("https://api.fetchproof.com/v1/youtube/video/sponsors?url=YOUR_URL", {
method: 'GET',
headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());Python
import os
import requests
response = requests.get("https://api.fetchproof.com/v1/youtube/video/sponsors?url=YOUR_URL",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)Responses
200Success. Envelope: success / credits_remaining / credits_charged.
application/json
object
successrequired
boolean
credits_remainingrequired
integer
credits_chargedrequired
integer
videorequired
object
idrequired
string
urlrequired
string
titlerequired
string
channelrequired
object
idrequired
string
urlrequired
string
handlerequired
string
titlerequired
string
isPaidPromotionrequired
boolean
suspectedSponsorsrequired
array
Array items
object
namerequired
string
websiterequired
string
confidencerequired
string
evidencerequired
array
Array items
object
sourcerequired
string
textrequired
string
sponsorDetectionrequired
object
statusrequired
string
methodsrequired
array
Array items
string
transcriptAvailablerequired
boolean
noterequired
string