Ads

Each parser reads one kind of page and returns the site’s own data. Send the page’s URL to scrape with a json format that names the parser. The data comes back in data.json.

curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=nike&search_type=keyword_exact_phrase","formats":[{"type":"json","parser":"meta-ads"}]}'

const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=nike&search_type=keyword_exact_phrase",
    formats: [{ type: "json", parser: "meta-ads" }],
  }),
});
console.log(await response.json());

import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=nike&search_type=keyword_exact_phrase",
        "formats": [{"type": "json", "parser": "meta-ads"}],
    },
)
print(response.json())

Send a parser’s options in the same format, like {"type": "json", "parser": "meta-ads", "options": {...}}. See Parsers for how they work.

Parser	Reads	Price
`meta-ads`	A Meta Ad Library search page with a q keyword, a page view with a view_all_page_id, or an ad page with an id.	1 credit per call.
`google-ads`	A Google Ads Transparency Center advertiser page, ad page or search page with a domain.	1 credit per call.
`tiktok-ads`	A TikTok Ad Library search page with an adv_name keyword or advertiser, or an ad page.	1 credit per call.
`linkedin-ads`	A LinkedIn Ad Library search page with a keyword or accountOwner, or an ad page or lnkd.in share link.	1 credit per call.

meta-ads

A Meta Ad Library search page with a q keyword, a page view with a view_all_page_id, or an ad page with an id.

Example page: https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=nike&search_type=keyword_exact_phrase
Returns: adId, adUrl, pageId, pageName, pageUrl, pageAvatarUrl.
Options: mediaType (The Ad Library’s own Media type filter: image, video, or text (no image or video)), platforms (The Ad Library’s own Platform filter: only ads shown on at least one of these platforms), language (The Ad Library’s own Language filter: a two-letter code like en. Only ads written in this language), shownFrom (The Ad Library’s own Impressions by date: ads shown on or after this day), shownTo (The Ad Library’s own Impressions by date: ads shown on or before this day), cursor (The cursor from the previous response. Send it as is), advertiser (The Facebook page: its numeric id, its username, its exact name as the Ad Library lists it, or its URL), country (ISO 3166-1 alpha-2 country code, or all. Any case is accepted), status.
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "adId": "1550534860016399",
      "adUrl": "https://www.facebook.com/ads/library/?id=1550534860016399",
      "pageId": "115939511520844",
      "pageName": "Perfect themes",
      "pageUrl": "https://facebook.com/100093512920259",
      "pageAvatarUrl": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.35426-6/701421303_1593266515068546_6584706353812290058_n.jpg?stp=dst-jpg_s60…",
      "pageCategories": [
        "Topic"
      ],
      "pageLikes": 18581,
      "isActive": true,
      "firstShownAt": "2026-05-19T07:00:00.000Z",
      "lastShownAt": null,
      "platforms": [
        "facebook",
        "instagram",
        "audienceNetwork"
      ],
      "format": "image",
      "text": "🔥🍭Themepack is a FREE and personalized APP😍 various styles of Theme💎 、Weather💖、Photo😊、Clock、Calendar to pick any…",
      "linkUrl": "http://play.google.com/store/apps/details?id=com.iconchanger.widget.theme.shortcut",
      "linkTitle": "𝕊𝕦𝕡𝕖𝕣 𝕙𝕠𝕥 𝕨𝕚𝕕𝕘𝕖𝕥𝕤 𝕒𝕡𝕡 ！",
      "linkDescription": null,
      "ctaText": "Install now",
      "imageUrls": [
        "https://scontent-phl2-1.xx.fbcdn.net/v/t39.35426-6/700927950_933331229664450_6487763311056032772_n.jpg?_nc_cat=111&ccb=…"
      ],
      "videoUrls": [],
      "cards": [],
      "versions": null,
      "categories": [],
      "paidBy": null,
      "spendMin": null,
      "spendMax": null,
      "spendCurrency": null,
      "impressionsMin": null,
      "impressionsMax": null,
      "reachMin": null,
      "reachMax": null,
      "countries": []
    }
  ],
  "cursor": "AQHTFYpc21jgjbhLWsCOd9JSuy7msUL1luJh8uiG-cX_v-3pw-d_l39pX5QljfX7STmR"
}

google-ads

A Google Ads Transparency Center advertiser page, ad page or search page with a domain. Set options.view to advertisers on a search page to look up advertisers by the domain’s name.

Example page: https://adstransparency.google.com/?region=US&domain=nike.com
Returns: adId, adUrl, advertiserId, advertiserName, advertiserUrl, domain.
Options: query (A domain like nike.com. Google’s library finds ads by domain or advertiser, not by keyword), advertiser, mediaType, platform (Google’s own Platform filter: where the ad was shown. Google leaves out ads shown before 4 September 2023 when it is set), shownFrom (Google’s own Date range: ads shown on or after this day), shownTo (Google’s own Date range: ads shown on or before this day), cursor (The cursor from the previous response. Send it as is), advertiserId (Advertiser id like AR18378488041124659201. Send it with adId; adUrl already has it), limit (How many advertisers to ask Google for, 1 to 100. Google ranks the list for the count you ask, so a larger limit is not the same list with more rows added, and there are no further pages. Fewer come back when Google has fewer matches).
Price: 1 credit per call. Works without an API key.

Example response

{
  "results": [
    {
      "adId": "CR00802554745662210049",
      "adUrl": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR00802554745662210049",
      "advertiserId": "AR16735076323512287233",
      "advertiserName": "Nike, Inc.",
      "advertiserUrl": "https://adstransparency.google.com/advertiser/AR16735076323512287233",
      "domain": "nike.com",
      "format": "video",
      "firstShownAt": "2026-11-03T18:57:15.000Z",
      "lastShownAt": "2026-11-04T21:31:04.000Z",
      "daysShown": 2,
      "previewUrl": "https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCus…",
      "imageUrl": null
    }
  ],
  "totalMin": 8000,
  "totalMax": 9000,
  "cursor": "CgoAP7zmghyLjfUzEhCWvRtPpsg95u2/n40AAAAAGgn8+GWT+NWZIHk="
}

tiktok-ads

A TikTok Ad Library search page with an adv_name keyword or advertiser, or an ad page.

Example page: https://library.tiktok.com/ads?region=DE&adv_name=adidas&query_type=1
Returns: adId, adUrl, advertiserName, headline, firstShownAt, lastShownAt.
Options: advertiser (An advertiser name. TikTok matches the name exactly, so use it as tiktok.ads.ad gives it, like Nike, Inc. When no listed advertiser has exactly this name, the closest listed name is used. Send this or query, not both), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "adId": "1871324448424097",
      "adUrl": "https://library.tiktok.com/ads/detail/?ad_id=1871324448424097",
      "advertiserName": "adidas AG",
      "headline": "adidas Hyperboost Euphoria",
      "firstShownAt": "2026-07-30T00:00:00.000Z",
      "lastShownAt": "2026-08-19T00:00:00.000Z",
      "reachMin": 1000000,
      "reachMax": 10000000,
      "videoUrl": "https://library.tiktok.com/api/v1/cdn/1793833904/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS9iZGQ3MjhjMGE4ZGM1ODQ3YzI4YWM2…",
      "thumbnailUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o45ljvYzEkiDA0dAUAy8mEiUBVCYs3aAhIaos~tplv-tiktokx-origin…",
      "imageUrls": [
        "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o45ljvYzEkiDA0dAUAy8mEiUBVCYs3aAhIaos~tplv-tiktokx-origin…"
      ]
    }
  ],
  "total": null,
  "cursor": "eyJsYXN0X3NvcnQiOlszMC41MzQyNTIsMTc4NzA5NzYwMDAwMF0sIm5leHRfY3Vyc29yIjoxMn0=~ifbul0fcf5.ifeb8tduky.ifeb8tdulu.ifbu48choh.ifeb8tdsyq.ifjx2ki5k2.ifbtkmpele.ifk..."
}

linkedin-ads

A LinkedIn Ad Library search page with a keyword or accountOwner, or an ad page or lnkd.in share link.

Example page: https://www.linkedin.com/ad-library/search?keyword=software&countries=DE
Returns: adId, adUrl, creativeType, format, advertiserName, advertiserUrl.
Options: advertiser, within (Only ads shown in the last 30 days or the last year), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "adId": "1624678994",
      "adUrl": "https://www.linkedin.com/ad-library/detail/1624678994",
      "creativeType": "SPONSORED_STATUS_UPDATE",
      "format": "Single Image Ad",
      "advertiserName": "Torii",
      "advertiserUrl": null,
      "advertiserAvatarUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQGF3JEvj2zgcA/company-logo_100_100/B4EZ9IPSWCJYAI-/0/1783623394930/toriihq_l…",
      "postedBy": null,
      "text": "Torii shows you every SaaS and AI app in the estate, who has access to each one, and what it actually costs. Most…",
      "headline": "You cannot optimize software you cannot see.",
      "imageUrls": [
        "https://media.licdn.com/dms/image/v2/D4E10AQG2Y8yC_MDg-Q/image-shrink_1280/B4EaGeSmFVIgAg-/0/1793657037813/torii-discov…"
      ]
    }
  ],
  "total": 148790,
  "cursor": "1624832654-1793655819560"
}

Get started

Parsers

Guides

Plans and billing

meta-ads

google-ads

tiktok-ads

linkedin-ads

​meta-ads

​google-ads

​tiktok-ads

​linkedin-ads

meta-ads

google-ads

tiktok-ads

linkedin-ads