Skip to content

Video Sponsors

GET/v1/youtube/video/sponsors1 credit

Detects a video's likely sponsors from its description links, promo codes and, when the description names none, its transcript. Each suspected sponsor comes with a confidence level and the evidence found.

01Query parameters

NameTypeDescription
urlrequiredstringYouTube video URL: a watch, youtu.be, Shorts, live or embed link.
languageoptionalstringLanguage code of the caption track used for the transcript check (e.g. `en`). Without it, English is used.

02Request

curl "https://api.scrapesocial.ai/v1/youtube/video/sponsors?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DAVO0ifle-OU" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/youtube/video/sponsors?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DAVO0ifle-OU

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "video": {
    "id": "AVO0ifle-OU",
    "url": "https://www.youtube.com/watch?v=AVO0ifle-OU",
    "title": "Why You Should Meal Prep Like A Restaurant",
    "channel": {
      "id": "UC3vQEjRhwgH2HAOBKwLjxNA",
      "url": "https://www.youtube.com/@letsKWOOWK",
      "handle": "letsKWOOWK",
      "title": "KWOOWK",
      "thumbnail": "https://yt3.ggpht.com/qmx-SPJT3bDScwd8KC4APZP82cpOoMN1b-kqdl5eASn8pub6jSBxWpq3OO88Wa1fQGWmPVpU=s48-c-k-c0x00ffffff-no-rj"
    },
    "isPaidPromotion": true
  },
  "suspectedSponsors": [
    {
      "name": "Betterhelp",
      "website": "betterhelp.com",
      "confidence": "medium",
      "evidence": [
        {
          "source": "description_link",
          "text": "If you're struggling, consider therapy with our sponsor BetterHelp. Click https://betterhelp.com/KWOOWK for a 10% discount on your first month of therapy with a licensed professional specific to your needs. I bought way"
        }
      ]
    }
  ],
  "sponsorDetection": {
    "status": "found",
    "methods": [
      "paid promotion badge",
      "description"
    ],
    "transcriptChecked": false,
    "transcriptAvailable": false,
    "note": "Sponsors are inferred from public description, links, promo-code text, and transcript evidence."
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Experimental. `confidence` is `high` when two kinds of evidence agree, `medium` for one, and `low` when only the transcript points to a sponsor. `sponsorDetection.status` is `found` or `not_found`; `isPaidPromotion` reflects YouTube's paid-promotion disclosure.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

  • 400missing_parameter

    A required parameter is missing or invalid.

  • 403private_account

    The account is private or age-restricted.

  • 404not_found

    No such account.

  • 503upstream_error

    The platform did not answer; retry shortly.