{"query":"meta ad library","count":25,"total":82,"results":[{"id":"treg.meta-ads.library.advertiser","provider":"treg","provider_display":"treg","name":"meta-ads.library.advertiser — routed: best of 4 providers, own keys first","summary":"The ads one Facebook page is running in the Meta Ad Library, by page id, company name, domain or Facebook URL — provider-native ad rows in `ads`","method":"POST","path":"/meta-ads.library.advertiser","scope":"","tier":"core","kind":"routed","domain":"library","call_template":"treg call treg.meta-ads.library.advertiser --method POST --data '{\"page_id\":\"…\"}'","cost":{"type":"per_success","value":0.0012,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"varies":true,"note":"Not free: $0.0012–$0.011 per hit across 4 providers, 0% markup. A call also pays each provider tried before the hit that bills a miss (1 of 4 do), up to X-Treg-Route-Max-Cost (default $1); X-Treg-Route-Waterfall: 0 pays for one provider only","usd":0.0012},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.ads == []"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"page_id":{"type":"str","required":false,"note":"identity"},"company_name":{"type":"str","required":false,"note":"identity"},"company_domain":{"type":"str","required":false,"note":"identity"},"facebook_url":{"type":"url","required":false,"note":"identity"}},"note":"Send what you know; treg sends each provider only the fields it accepts ({page_id} | {company_name} | {company_domain} | {facebook_url}). Omit a field you don't have: a url field holding something else, such as N/A, is refused (422 invalid_identity). On a miss it tries the next provider, cheapest first. Options are X-Treg-Route-* headers, never body fields. The answer is {output, raw, _treg}; X-Treg-Served-By names the provider."},"test_request":{"body":{"page_id":"…"}},"routed_children":["adyntel.meta-ads.library.advertiser","anyapi.facebook.company_ads","crawl4ai.meta-ads.library.advertiser","scrapecreators.x.v1-facebook-adlibrary-company-ads"],"capability":"meta-ads.library.advertiser","capability_description":"Ads a specific Page is running now","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":300131,"decided":299979,"ok_rate":0.7951,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"meta-ad-library.meta-ads.library.advertiser","provider":"meta-ad-library","provider_display":"Meta Ad Library","name":"Ads a Facebook Page runs, by Page id — Meta ad library","summary":"List every ad a specific Facebook Page is currently running","method":"GET","path":"/ads_archive","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call meta-ad-library.meta-ads.library.advertiser --query 'search_page_ids=[\"20531316728\"]' --query 'ad_reached_countries=[\"US\"]' --query fields=id,page_id,page_name,ad_creative_bodies,ad_creative_link_titles,ad_snapshot_url,ad_delivery_start_time,ad_delivery_stop_time,publisher_platforms,media_type","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"no per-call charge; Graph API app-level rate limits apply","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://developers.facebook.com/docs/graph-api/reference/ads_archive/","has_example":false,"input":{"queryArrayEncoding":"json","queryParams":{"search_page_ids":{"type":"array","required":true,"note":"JSON array of up to 10 numeric Facebook Page ids. You need the id, not the vanity handle — get it from a keyword search's page_id, or from the Page's About section","example":["20531316728"]},"ad_reached_countries":{"type":"array","required":true,"example":["US"]},"fields":{"type":"string","required":true,"example":"id,page_id,page_name,ad_creative_bodies,ad_creative_link_titles,ad_snapshot_url,ad_delivery_start_time,ad_delivery_stop_time,publisher_platforms,media_type"},"ad_active_status":{"type":"string","required":false,"note":"ACTIVE (default) | INACTIVE | ALL","example":"ACTIVE"},"ad_delivery_date_min":{"type":"string","required":false,"note":"YYYY-MM-DD"},"limit":{"type":"integer","required":false,"example":50},"after":{"type":"string","required":false}},"note":"the competitor-monitoring shape: pin the advertiser, page through everything they run. One Page can run hundreds of near-identical creative variants, so count DISTINCT ad_creative_bodies rather than rows when sizing a competitor's output"},"test_request":null,"capability":"meta-ads.library.advertiser","capability_description":"Ads a specific Page is running now","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":589,"decided":560,"ok_rate":0.9964,"p50_ms":504,"p95_ms":2088,"last_ok_days":2,"hit_rate":null,"hit_samples":0}},{"id":"crawl4ai.meta-ads.library.advertiser","provider":"crawl4ai","provider_display":"Crawl4AI","name":"Meta Ad Library ads of one advertiser","summary":"List the ads one Facebook page runs, from the Meta Ad Library, with dates, platforms, text, media, and spend for political ads.","method":"POST","path":"/recipes/meta-ads-advertiser","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call crawl4ai.meta-ads.library.advertiser --method POST --data '{\"page\":\"15087023444\"}'","cost":{"type":"per_success","value":1.65,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://api.crawl4ai.com/recipes","checked":"2026-10-31","confidence":"verified","note":"treg's account price: 1.65 credits a call whatever pages the run fetched, second-source records included; a reply with no rows, a refused input and a failed run are free. The x-c4-cost header settles the actual charge.","usd":0.00165},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-11","added":"2026-10-11","docs_url":"https://crawl4ai.com/llms.txt","has_example":true,"input":{"bodyType":"json","body":{"active_status":{"type":"string","required":false,"note":"active or all; empty takes an Ad Library URL's value, else active","example":"active"},"country":{"type":"string","required":false,"note":"ALL or two letters; empty takes an Ad Library URL's value, else ALL","example":"US"},"limit":{"type":"integer","required":false,"note":"default 20","example":20},"page":{"type":"string","required":true,"note":"the page id, its Ad Library or Facebook URL, a company name (Tolteck) or web domain (tolteck.com); the warnings name the page a name or domain matched, or that none did","example":"15087023444"}}},"body_allowlist":true,"test_request":{"body":{"page":"15087023444"}},"capability":"meta-ads.library.advertiser","capability_description":"Ads a specific Page is running now","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":420696,"decided":415793,"ok_rate":0.9581,"p50_ms":4852,"p95_ms":65211,"last_ok_days":0,"hit_rate":0.1729,"hit_samples":398372}},{"id":"adyntel.meta-ads.library.advertiser","provider":"adyntel","provider_display":"Adyntel","name":"Find a company's Facebook and Instagram ads","summary":"Return one page of Meta ads for a company or Facebook page.","method":"POST","path":"/facebook","scope":"any_account","tier":"core","kind":"data","domain":"advertising","call_template":"treg call adyntel.meta-ads.library.advertiser --method POST --data '{\"company_domain\":\"nike.com\",\"country_code\":\"US\"}'","cost":{"type":"per_success","value":1,"currency":"credit","per":1,"unit":"page","source":"observed","source_url":"https://www.adyntel.com/facebook-ads-scraper","checked":"2026-09-22","confidence":"verified","note":"One credit for a page with results; HTTP 204 misses are free.","usd":0.011},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":204,"means":"No matching ads were returned."},"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-22","added":"2026-09-23","docs_url":"https://docs.adyntel.com/ad-libraries/meta","has_example":true,"input":{"body":{"company_domain":{"type":"string","required":true,"example":"nike.com"},"facebook_url":{"type":"string","required":false,"example":"https://www.facebook.com/nike"},"country_code":{"type":"string","required":false,"example":"US"},"continuation_token":{"type":"string","required":false,"note":"Use the token from the previous response for the next page."},"media_type":{"type":"string","required":false,"enum":["image","meme","image_and_meme","video"]},"active_status":{"type":"string","required":false,"enum":["inactive","all"]}},"note":"Provide company_domain or facebook_url. Automatic all-page scraping and webhooks are not exposed on the shared key."},"body_allowlist":true,"test_request":{"body":{"company_domain":"nike.com","country_code":"US"}},"capability":"meta-ads.library.advertiser","capability_description":"Ads a specific Page is running now","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":205787,"decided":204477,"ok_rate":0.9999,"p50_ms":2002,"p95_ms":60349,"last_ok_days":0,"hit_rate":0.1622,"hit_samples":89569}},{"id":"anyapi.facebook.company_ads","provider":"anyapi","provider_display":"AnyAPI","name":"Facebook Company Ads","summary":"List the Meta Ad Library ads a company is running by page ID or company name (creative text, format, platforms, and run dates) with cursor pagination.","method":"POST","path":"/v1/run/facebook.company_ads","scope":"","tier":"extended","kind":"data","domain":"company","call_template":"treg call anyapi.facebook.company_ads --method POST --data '{\"companyName\":\"nike\",\"sortBy\":\"recent\"}'","cost":{"type":"per_success","value":0.0012,"currency":"USD","unit":"call","reported_charge":{"path":"costUsd","unit":"usd"},"source":"observed","source_url":"https://api.getanyapi.com/v1/apis/facebook.company_ads","checked":"2026-10-02","confidence":"verified","note":"2 sources serve this, cheapest first; a failed attempt retries on the next, up to $0.0012 at the dearest. The charge follows the answer's `costUsd`, not the listed price. Send X-Treg-Route-Max-Cost to refuse any source dearer than your ceiling.","usd":0.0012},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-19","added":"2026-09-19","docs_url":"https://getanyapi.com/api/facebook/company-ads","has_example":true,"input":{"body":{"companyName":{"type":"string","required":false,"note":"Company name to search (e.g. \"nike\"). Exact-match and case-sensitive against the Meta Ad Library index; an advertiser with no indexed page returns found:false.","example":"nike"},"country":{"type":"string","required":false,"note":"Two-letter country code to scope results. Defaults to all countries."},"cursor":{"type":"string","required":false,"note":"Opaque pagination cursor from a previous response's nextCursor."},"endDate":{"type":"string","required":false,"note":"Filter to ads with impressions on or before this date, in YYYY-MM-DD format."},"language":{"type":"string","required":false,"note":"Two-letter language code to filter ads (e.g. \"EN\", \"ES\", \"FR\")."},"mediaType":{"type":"string","required":false,"note":"Creative media type filter.","enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"]},"pageId":{"type":"string","required":false,"note":"Company's Ad Library page ID. Provide either pageId or companyName."},"sortBy":{"type":"string","required":false,"note":"Sort order: impressions (highest first, the default) or recent (most recent).","enum":["impressions","recent"],"example":"recent"},"startDate":{"type":"string","required":false,"note":"Filter to ads with impressions on or after this date, in YYYY-MM-DD format."},"status":{"type":"string","required":false,"note":"Ad status filter. Defaults to ACTIVE.","enum":["ALL","ACTIVE","INACTIVE"]}},"bodyType":"json","queryArrayEncoding":"comma","queryParams":{"fields":{"type":"string","required":false,"note":"Comma-separated keys (dotted paths descend) to keep on each result item. Trims the response, not the charge."},"max_items":{"type":"integer","required":false,"min":0,"note":"Caps the result rows returned; `_truncated` says how many were withheld. Not the charge."},"summary":{"type":"boolean","required":false,"note":"`true` returns only an outline: keys, item counts, per-field sizes."},"jq":{"type":"string","required":false,"note":"jq expression over the result envelope; its output replaces `output`. A failed expression returns the full result with `jqError`."}}},"test_request":{"body":{"companyName":"nike","sortBy":"recent"}},"capability":"meta-ads.library.advertiser","capability_description":"Ads a specific Page is running now","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":174137,"decided":173933,"ok_rate":0.9989,"p50_ms":1843,"p95_ms":4340,"last_ok_days":0,"hit_rate":0.691,"hit_samples":173607}},{"id":"scrapecreators.x.v1-facebook-adlibrary-company-ads","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Facebook ad library company ads by page id or name","summary":"Fetches all ads currently running for a specific company from the Meta Ad Library.","method":"GET","path":"/v1/facebook/adLibrary/company/ads","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call scrapecreators.x.v1-facebook-adlibrary-company-ads --query pageId=367152833370567","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","reported_charge":{"path":"credits_charged","unit":"credit"},"source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-20","added":"2026-07-28","docs_url":"https://docs.scrapecreators.com/facebook/adLibrary/company/ads","has_example":true,"input":{"queryParams":{"pageId":{"type":"string","required":false,"note":"The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName","example":"367152833370567"},"companyName":{"type":"string","required":false,"note":"The name of the company. Can either use this or pageId","example":"Lululemon"},"country":{"type":"string","required":false,"note":"This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.","example":"ALL"},"status":{"type":"string","required":false,"note":"Status of the ad. Defaults to ACTIVE.","example":"ACTIVE"},"media_type":{"type":"string","required":false,"note":"Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.","example":"ALL"},"language":{"type":"string","required":false,"note":"Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc","example":"EN"},"sort_by":{"type":"string","required":false,"note":"Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.","example":"total_impressions"},"start_date":{"type":"string","required":false,"note":"Start date to search for. Format: YYYY-MM-DD","example":"2025-01-01"},"end_date":{"type":"string","required":false,"note":"End date to search for. Format: YYYY-MM-DD","example":"2025-12-31"},"cursor":{"type":"string","required":false,"note":"Cursor to paginate through results","example":"AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP"},"trim":{"type":"boolean","required":false,"note":"Set to true for a trimmed down version of the response","example":"false"}}},"test_request":{"queryParams":{"pageId":"367152833370567"}},"capability":"meta-ads.library.advertiser","capability_description":"Ads a specific Page is running now","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":562857,"decided":526773,"ok_rate":0.9899,"p50_ms":1857,"p95_ms":4976,"last_ok_days":0,"hit_rate":0.823,"hit_samples":438165}},{"id":"meta-ad-library.meta-ads.library.search","provider":"meta-ad-library","provider_display":"Meta Ad Library","name":"Search the Meta ad library by keyword","summary":"Search publicly running Facebook and Instagram ads by keyword","method":"GET","path":"/ads_archive","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call meta-ad-library.meta-ads.library.search --query 'ad_reached_countries=[\"US\"]' --query fields=id,page_id,page_name,ad_creative_bodies,ad_creative_link_titles,ad_creative_link_captions,ad_snapshot_url,ad_delivery_start_time,ad_delivery_stop_time,publisher_platforms,languages,estimated_audience_size","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"no per-call charge; access is gated on a one-time Meta identity verification, and the app is subject to Graph API rate limits (per-app hourly quota, reported in x-app-usage)","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://developers.facebook.com/docs/graph-api/reference/ads_archive/","has_example":false,"input":{"queryArrayEncoding":"json","queryParams":{"search_terms":{"type":"string","required":false,"note":"max 100 characters; matched against the ad's text. Required in practice unless you filter by search_page_ids instead","example":"project management software"},"search_type":{"type":"string","required":false,"note":"KEYWORD_UNORDERED (default, all words in any order) | KEYWORD_EXACT_PHRASE","example":"KEYWORD_UNORDERED"},"ad_reached_countries":{"type":"array","required":true,"note":"REQUIRED on every ads_archive call. JSON array of ISO country codes, URL-encoded — [\"US\"] — or ALL","example":["US"]},"fields":{"type":"string","required":true,"note":"comma-separated; nothing but id comes back by default","example":"id,page_id,page_name,ad_creative_bodies,ad_creative_link_titles,ad_creative_link_captions,ad_snapshot_url,ad_delivery_start_time,ad_delivery_stop_time,publisher_platforms,languages,estimated_audience_size"},"ad_active_status":{"type":"string","required":false,"note":"ACTIVE (default) | INACTIVE | ALL — ALL is what you want for creative research, since a competitor's best-performing ad may have finished","example":"ALL"},"ad_type":{"type":"string","required":false,"note":"ALL (default) | POLITICAL_AND_ISSUE_ADS | HOUSING_ADS | EMPLOYMENT_ADS | FINANCIAL_PRODUCTS_AND_SERVICES_ADS","example":"ALL"},"ad_delivery_date_min":{"type":"string","required":false,"note":"YYYY-MM-DD; ads that were delivering on or after this date","example":"2026-06-01"},"ad_delivery_date_max":{"type":"string","required":false,"note":"YYYY-MM-DD"},"media_type":{"type":"string","required":false,"note":"ALL | IMAGE | MEME | VIDEO | NONE","example":"VIDEO"},"publisher_platforms":{"type":"array","required":false,"note":"FACEBOOK | INSTAGRAM | AUDIENCE_NETWORK | MESSENGER | WHATSAPP | OCULUS | THREADS","example":["INSTAGRAM"]},"languages":{"type":"array","required":false,"note":"ISO 639-1 codes (plus CMN, YUE)","example":["en"]},"estimated_audience_size_min":{"type":"integer","required":false,"note":"one of the fixed buckets 100 | 1000 | 5000 | 10000 | 50000 | 100000 | 500000 | 1000000"},"limit":{"type":"integer","required":false,"note":"page size; 25 by default, a few hundred is the practical ceiling before Meta starts timing out","example":25},"after":{"type":"string","required":false,"note":"paging.cursors.after from the previous response"}},"note":"give it either search_terms or search_page_ids — a call with neither returns an error, not the whole library. ad_snapshot_url is the human-viewable render of the creative and needs the access token appended to load. Results are ads Meta has KEPT: commercial ads leave the library some time after they stop running, so this is a live-ish view, not an archive"},"test_request":null,"capability":"meta-ads.library.search","capability_description":"Search publicly running ads","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":1196,"decided":1173,"ok_rate":0.9983,"p50_ms":1299,"p95_ms":3978,"last_ok_days":1,"hit_rate":null,"hit_samples":0}},{"id":"crawl4ai.meta-ads.library.search","provider":"crawl4ai","provider_display":"Crawl4AI","name":"Meta Ad Library ads for a keyword","summary":"Search the Meta Ad Library by keyword and get each ad's page, dates, platforms, text and media, with spend for political ads.","method":"POST","path":"/recipes/meta-ads-search","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call crawl4ai.meta-ads.library.search --method POST --data '{\"query\":\"running shoes\"}'","cost":{"type":"per_success","value":1.65,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://api.crawl4ai.com/recipes","checked":"2026-10-31","confidence":"verified","note":"treg's account price: 1.65 credits a call whatever pages the run fetched, second-source records included; a reply with no rows, a refused input and a failed run are free. The x-c4-cost header settles the actual charge.","usd":0.00165},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-10-11","added":"2026-10-11","docs_url":"https://crawl4ai.com/llms.txt","has_example":true,"input":{"bodyType":"json","body":{"active_status":{"type":"string","required":false,"note":"active or all; default active","example":"active"},"country":{"type":"string","required":false,"note":"ALL or two letters (US, GB, DE); default ALL","example":"US"},"limit":{"type":"integer","required":false,"note":"at most 100; past the 30 ads one view shows, the search is split by media type, out of the Library's order; default 20","example":20},"query":{"type":"string","required":true,"example":"running shoes"}}},"body_allowlist":true,"test_request":{"body":{"query":"running shoes"}},"capability":"meta-ads.library.search","capability_description":"Search publicly running ads","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":168353,"decided":168251,"ok_rate":0.9999,"p50_ms":1992,"p95_ms":10101,"last_ok_days":0,"hit_rate":0.4505,"hit_samples":168230}},{"id":"apify.meta-ads.library.search","provider":"apify","provider_display":"Apify","name":"Scrape the Meta ad library by Page or search URL","summary":"Scrape publicly running Facebook and Instagram ads for a page or Ad Library search","method":"POST","path":"/actors/apify~facebook-ads-scraper/run-sync-get-dataset-items","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call apify.meta-ads.library.search --method POST --query maxItems=1 --query maxTotalChargeUsd=0.05 --query timeout=90 --data '{\"startUrls\":[{\"url\":\"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=project%20management\"}],\"resultsLimit\":1,\"activeStatus\":\"active\",\"isDetailsPerAd\":false,\"onlyTotal\":true,\"enrichWithEcommerceData\":false}'","cost":{"type":"per_result","value":0.005,"currency":"USD","per":1,"unit":"ad","source":"observed","source_url":"https://apify.com/pricing","checked":"2026-09-26","confidence":"verified","note":"pay-per-event, TIERED by the caller's Apify plan — one apify-default-dataset-item event per ad: FREE 0.0058, BRONZE 0.005 (the value here), SILVER 0.0042, GOLD 0.0034, PLATINUM 0.0021, DIAMOND 0.001; enrichWithEcommerceData adds an ecommerce-enrichment event per ad (FREE 0.0057), pinned off on treg's key. No start event. OBSERVED 2026-09-26 on the platform key: 1 ad billed chargedEventCounts {apify-default-dataset-item: 1}, at the rate-card price for that key's plan tier. Charged per ad produced even if the run is cut short — cap it with maxTotalChargeUsd","usd":0.005},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-26","added":"2026-07-28","docs_url":"https://apify.com/apify/facebook-ads-scraper","has_example":true,"input":{"queryParams":{"maxItems":{"type":"integer","required":false,"note":"optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit","example":50},"maxTotalChargeUsd":{"type":"number","required":false,"note":"the spend cap Apify enforces on every event this run bills, in dollars. treg's key requires it, above 0 and at most 1, and holds it for the call","example":0.5},"timeout":{"type":"integer","required":false,"note":"treg's key requires 1-90 so the run and its rows arrive before any wait gives up (a larger pull needs your own key). seconds before the synchronous run is cut off. This route blocks until the actor finishes and Apify closes the connection at 300s regardless — use the async pair below for anything large","example":90}},"body":{"startUrls":{"type":"array","required":true,"note":"[{\"url\": \"…\"}] — either a Facebook Page URL or a full Meta Ad Library search URL (facebook.com/ads/library/?q=…&country=US)","example":[{"url":"https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&q=project%20management"}]},"resultsLimit":{"type":"integer","required":false,"note":"max ads PER URL; unlimited if omitted, which is how runs get expensive","example":50},"activeStatus":{"type":"string","required":false,"note":"\"active\" | \"inactive\" | \"\" for both","example":"active"},"isDetailsPerAd":{"type":"boolean","required":false,"note":"true adds Instagram data, spend info and EU reach/targeting per ad — richer than Meta's own API, and slower","example":false},"includeAboutPage":{"type":"boolean","required":false,"note":"true adds the advertiser's address, admin country and page history"},"onlyAdsNewerThan":{"type":"string","required":false,"note":"YYYY-MM-DD or a relative phrase like \"2 months\"","example":"2026-06-01"},"onlyAdsOlderThan":{"type":"string","required":false},"onlyTotal":{"type":"boolean","required":false,"note":"true returns just the ad COUNT instead of the ads — one cheap result row when all you need is how much a competitor is running","example":false},"enrichWithEcommerceData":{"type":"boolean","required":false,"enum":[false],"note":"true follows landing pages for product names and prices and bills an extra ecommerce-enrichment event per ad; treg's key requires false, your own key may enable it","example":false}},"bodyType":"json","note":"the response is the dataset items array directly — no run envelope, no polling. Result count is what you pay for, so onlyTotal:true is the cheap probe before a full pull. Unofficial: this reads the Ad Library web UI, so field availability tracks whatever Meta currently renders"},"test_request":{"queryParams":{"maxItems":1,"maxTotalChargeUsd":0.05,"timeout":90},"body":{"startUrls":[{"url":"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=project%20management"}],"resultsLimit":1,"activeStatus":"active","isDetailsPerAd":false,"onlyTotal":true,"enrichWithEcommerceData":false}},"capability":"meta-ads.library.search","capability_description":"Search publicly running ads","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":1712,"decided":1560,"ok_rate":0.9994,"p50_ms":22015,"p95_ms":73858,"last_ok_days":1,"hit_rate":null,"hit_samples":0}},{"id":"adyntel.meta-ads.library.search","provider":"adyntel","provider_display":"Adyntel","name":"Search Facebook and Instagram ads by keyword","summary":"Return one page of Meta Ad Library matches for a keyword.","method":"POST","path":"/facebook_ad_search","scope":"any_account","tier":"core","kind":"data","domain":"advertising","call_template":"treg call adyntel.meta-ads.library.search --method POST --data '{\"keyword\":\"webinar\",\"country_code\":\"US\"}'","cost":{"type":"per_success","value":1,"currency":"credit","per":1,"unit":"page","source":"observed","source_url":"https://docs.adyntel.com/ad-libraries/meta-ad-search","checked":"2026-09-22","confidence":"verified","note":"One credit for a page with results; HTTP 204 misses are free.","usd":0.011},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":204,"means":"No matching ads were returned."},"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-22","added":"2026-09-23","docs_url":"https://docs.adyntel.com/openapi-docs/existing-endpoints","has_example":true,"input":{"body":{"keyword":{"type":"string","required":true,"example":"webinar"},"country_code":{"type":"string","required":false,"example":"US"},"continuation_token":{"type":"string","required":false}}},"body_allowlist":true,"test_request":{"body":{"keyword":"webinar","country_code":"US"}},"capability":"meta-ads.library.search","capability_description":"Search publicly running ads","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":10375,"decided":10374,"ok_rate":0.9999,"p50_ms":3028,"p95_ms":6136,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"scrapecreators.x.v1-facebook-adlibrary-search-ads","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Search Facebook ad library ads by keyword","summary":"Searches the Meta Ad Library by keyword and returns matching ads.","method":"GET","path":"/v1/facebook/adLibrary/search/ads","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call scrapecreators.x.v1-facebook-adlibrary-search-ads --query query=running","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","reported_charge":{"path":"credits_charged","unit":"credit"},"source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://docs.scrapecreators.com/facebook/adLibrary/search/ads","has_example":false,"input":{"queryParams":{"query":{"type":"string","required":true,"note":"Keyword to search for","example":"running"},"sort_by":{"type":"string","required":false,"enum":["total_impressions","relevancy_monthly_grouped"],"note":"Order only. One of: total_impressions | relevancy_monthly_grouped. Defaults to impressions ranking (total_impressions). Controls result ORDER, not verified performance — does not guarantee non-null spend, impressions_text, or a positive impressions_index. Those fields are often null / -1 for commercial ads and are not verified performance metrics.","example":"total_impressions"},"search_type":{"type":"string","required":false,"note":"If you want to search by exact phrase or not","example":"keyword_unordered"},"ad_type":{"type":"string","required":false,"note":"Search for all ads or only political and issue ads","example":"all"},"country":{"type":"string","required":false,"note":"This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.","example":"ALL"},"status":{"type":"string","required":false,"note":"Status of the ad. Defaults to ACTIVE.","example":"ACTIVE"},"media_type":{"type":"string","required":false,"note":"Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme.","example":"ALL"},"start_date":{"type":"string","required":false,"note":"Impressions start date. Needs to be in YYYY-MM-DD format.","example":"2025-01-05"},"end_date":{"type":"string","required":false,"note":"Impressions end date. Needs to be in YYYY-MM-DD format.","example":"2025-02-16"},"cursor":{"type":"string","required":false,"note":"Cursor to paginate through results","example":"AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"},"trim":{"type":"boolean","required":false,"note":"Set to true for a trimmed down version of the response","example":"false"}},"note":"sort_by is order-only: ranking by total_impressions does not mean the response carries verified spend or impression counts. Search may return a non-null collation_count that is null on scrapecreators.x.v1-facebook-adlibrary-ad detail for the same ad — grouping semantics differ between search and detail; do not treat collation_count as creative-variant or budget counts."},"test_request":{"queryParams":{"query":"running"}},"capability":"meta-ads.library.search","capability_description":"Search publicly running ads","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":359883,"decided":359066,"ok_rate":0.9977,"p50_ms":1902,"p95_ms":5202,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"meta-ad-library.meta-ads.library.eu_reach","provider":"meta-ad-library","provider_display":"Meta Ad Library","name":"EU ad reach and audience breakdown — Meta ad library","summary":"Get the EU reach, audience breakdown and payer of ads delivered in Europe","method":"GET","path":"/ads_archive","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call meta-ad-library.meta-ads.library.eu_reach --query 'ad_reached_countries=[\"DE\",\"FR\"]' --query fields=id,page_name,eu_total_reach,age_country_gender_reach_breakdown,beneficiary_payers,target_ages,target_gender,target_locations,ad_creative_bodies,ad_delivery_start_time","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"no per-call charge; Graph API app-level rate limits apply","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://developers.facebook.com/docs/graph-api/reference/archived-ad/","has_example":false,"input":{"queryArrayEncoding":"json","queryParams":{"ad_reached_countries":{"type":"array","required":true,"note":"EU/EEA member states only — the DSA fields are populated for EU delivery and are absent everywhere else","example":["DE","FR"]},"fields":{"type":"string","required":true,"note":"the DSA disclosure set","example":"id,page_name,eu_total_reach,age_country_gender_reach_breakdown,beneficiary_payers,target_ages,target_gender,target_locations,ad_creative_bodies,ad_delivery_start_time"},"search_terms":{"type":"string","required":false,"example":"electric car"},"search_page_ids":{"type":"array","required":false,"note":"up to 10 Page ids, to scope to one advertiser"},"ad_active_status":{"type":"string","required":false,"example":"ALL"},"limit":{"type":"integer","required":false,"example":25}},"note":"Meta publishes these under the EU Digital Services Act: eu_total_reach is an actual number of accounts reached (not a range), age_country_gender_reach_breakdown splits it by country/age/gender, beneficiary_payers names who paid and who benefits, and target_ages / target_gender / target_locations expose the advertiser's declared targeting — the only place any Meta ad targeting is public. All of it is missing for non-EU delivery, which reads as an empty response field rather than an error"},"test_request":null,"capability":"meta-ads.library.eu_reach","capability_description":"EU reach, audience & declared targeting","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":2,"decided":0,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"meta-ad-library.meta-ads.library.political","provider":"meta-ad-library","provider_display":"Meta Ad Library","name":"Political and issue ads with spend — Meta ad library","summary":"Search political and issue ads and see who paid for them and roughly how much","method":"GET","path":"/ads_archive","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call meta-ad-library.meta-ads.library.political --query ad_type=POLITICAL_AND_ISSUE_ADS --query 'ad_reached_countries=[\"US\"]' --query fields=id,page_name,bylines,currency,spend,impressions,demographic_distribution,delivery_by_region,ad_creative_bodies,ad_delivery_start_time,ad_delivery_stop_time","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"no per-call charge; Graph API app-level rate limits apply","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://www.facebook.com/ads/library/api/","has_example":false,"input":{"queryArrayEncoding":"json","queryParams":{"ad_type":{"type":"string","required":true,"note":"POLITICAL_AND_ISSUE_ADS — this is what unlocks the spend/impressions/demographic fields","example":"POLITICAL_AND_ISSUE_ADS"},"ad_reached_countries":{"type":"array","required":true,"example":["US"]},"fields":{"type":"string","required":true,"note":"the disclosure fields only exist on this ad_type","example":"id,page_name,bylines,currency,spend,impressions,demographic_distribution,delivery_by_region,ad_creative_bodies,ad_delivery_start_time,ad_delivery_stop_time"},"search_terms":{"type":"string","required":false,"example":"climate"},"bylines":{"type":"array","required":false,"note":"JSON array of exact paid-for-by disclaimers; POLITICAL_AND_ISSUE_ADS only"},"delivery_by_region":{"type":"array","required":false,"note":"state / province names; POLITICAL_AND_ISSUE_ADS only","example":["California"]},"ad_delivery_date_min":{"type":"string","required":false,"note":"YYYY-MM-DD"},"limit":{"type":"integer","required":false,"example":25}},"note":"spend and impressions are RANGES — {\"lower_bound\":\"100\",\"upper_bound\":\"499\"} — never point values, so totals across ads can only be reported as a range. demographic_distribution and delivery_by_region come back as percentage breakdowns that sum to ~1. Political ads stay in the library for seven years, unlike commercial ones"},"test_request":null,"capability":"meta-ads.library.political","capability_description":"Political ads, who paid & spend range","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":29.5866,"observed":{"samples":0,"decided":0,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"scrapecreators.x.v1-facebook-adlibrary-ad","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Facebook ad library ad details by id or URL","summary":"Retrieves detailed information about a specific Facebook ad by its ID or URL.","method":"GET","path":"/v1/facebook/adLibrary/ad","scope":"","tier":"extended","kind":"data","domain":"ads","call_template":"treg call scrapecreators.x.v1-facebook-adlibrary-ad --query id=702369045530963","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","reported_charge":{"path":"credits_charged","unit":"credit"},"source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://docs.scrapecreators.com/facebook/adLibrary/ad","has_example":false,"input":{"queryParams":{"id":{"type":"string","required":false,"note":"Facebook Ad Id","example":"702369045530963"},"url":{"type":"string","required":false,"note":"Facebook Ad URL","example":"https://www.facebook.com/ads/library?id=1185617869915074"},"trim":{"type":"boolean","required":false,"note":"Set to true for a trimmed down version of the response","example":"false"},"cache_max_age":{"type":"string","required":false,"note":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Cac...","example":"7d"}}},"test_request":{"queryParams":{"id":"702369045530963"}},"capability":"","capability_description":"","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":25.0999,"observed":{"samples":127572,"decided":122908,"ok_rate":0.9991,"p50_ms":2039,"p95_ms":4651,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"scrapecreators.x.v1-facebook-adlibrary-ad-transcript","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Facebook ad library video ad transcript by id or URL","summary":"Retrieves a transcript for a single Facebook Ad Library video ad by ID or URL.","method":"GET","path":"/v1/facebook/adLibrary/ad/transcript","scope":"","tier":"extended","kind":"data","domain":"ads","call_template":"treg call scrapecreators.x.v1-facebook-adlibrary-ad-transcript --query id=1020359190509080","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","reported_charge":{"path":"credits_charged","unit":"credit"},"source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://docs.scrapecreators.com/facebook/adLibrary/ad/transcript","has_example":false,"input":{"queryParams":{"id":{"type":"string","required":false,"note":"Facebook Ad Id","example":"1020359190509080"},"url":{"type":"string","required":false,"note":"Facebook Ad URL","example":"https://www.facebook.com/ads/library?id=1020359190509080"},"cache_max_age":{"type":"string","required":false,"note":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Cac...","example":"7d"}}},"test_request":{"queryParams":{"id":"1020359190509080"}},"capability":"","capability_description":"","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":25.0999,"observed":{"samples":22057,"decided":15392,"ok_rate":0.9992,"p50_ms":6735,"p95_ms":11458,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"scrapecreators.x.v1-facebook-adlibrary-search-companies","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Search Facebook ad library companies by name — page ids","summary":"Searches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library endpoints.","method":"GET","path":"/v1/facebook/adLibrary/search/companies","scope":"","tier":"extended","kind":"data","domain":"ads","call_template":"treg call scrapecreators.x.v1-facebook-adlibrary-search-companies --query query=nike","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","reported_charge":{"path":"credits_charged","unit":"credit"},"source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://docs.scrapecreators.com/facebook/adLibrary/search/companies","has_example":false,"input":{"queryParams":{"query":{"type":"string","required":true,"note":"Keyword to search for","example":"nike"}}},"test_request":{"queryParams":{"query":"nike"}},"capability":"","capability_description":"","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":25.0999,"observed":{"samples":86378,"decided":86363,"ok_rate":0.9994,"p50_ms":601,"p95_ms":1138,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"meta-ads.x.account-adrules-library","provider":"meta-ads","provider_display":"Meta Ads","name":"Automated rules on your Meta ad account","summary":"Automated rules on the account — their conditions and actions","method":"GET","path":"/{ad_account_id}/adrules_library","scope":"own_account","tier":"extended","kind":"data","domain":"ads","call_template":"treg call meta-ads.x.account-adrules-library","cost":{"type":"free","value":0,"currency":"USD","unit":"call","note":"no per-call charge; counted against the app's Graph API rate limit","usd":0.0},"async":null,"platform_eligible":false,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://developers.facebook.com/docs/marketing-api/reference","has_example":false,"input":null,"test_request":null,"capability":"","capability_description":"","platform":"meta-ads","platform_label":"Meta Ads (Facebook & Instagram)","score":20.6131,"observed":{"samples":0,"decided":0,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"apify.tiktok-ads.library.search","provider":"apify","provider_display":"Apify","name":"Scrape the TikTok ad library by keyword","summary":"Scrape publicly running TikTok ads from TikTok's ad library by keyword or advertiser","method":"POST","path":"/actors/s-r~tiktok-ads-library/run-sync-get-dataset-items","scope":"any_account","tier":"core","kind":"data","domain":"library","call_template":"treg call apify.tiktok-ads.library.search --method POST --query maxItems=1 --query maxTotalChargeUsd=0.05 --query timeout=90 --data '{\"search\":\"nike\",\"region\":\"all\",\"query_type\":\"1\",\"limit\":1,\"offset\":0}'","cost":{"type":"per_result","value":0.003,"currency":"USD","per":1,"unit":"ad","source":"observed","source_url":"https://apify.com/pricing","checked":"2026-09-26","confidence":"verified","note":"pay-per-event: one scraped event per ad, $0.003 flat (no plan tiers), no start event. OBSERVED 2026-09-26 on the platform key: 1 ad billed chargedEventCounts {scraped: 1}, usageTotalUsd 0.003. Earlier runs (2026-07-31, 2026-08-13) returned empty datasets; the actor returns rows again","usd":0.003},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-26","added":"2026-07-28","docs_url":"https://apify.com/s-r/tiktok-ads-library","has_example":true,"input":{"queryParams":{"maxItems":{"type":"integer","required":false,"note":"optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit","example":50},"maxTotalChargeUsd":{"type":"number","required":false,"note":"the spend cap Apify enforces on every event this run bills, in dollars. treg's key requires it, above 0 and at most 1, and holds it for the call","example":0.5},"timeout":{"type":"integer","required":false,"note":"treg's key requires 1-90 so the run and its rows arrive before any wait gives up (a larger pull needs your own key)","example":90}},"body":{"search":{"type":"string","required":true,"note":"keyword or advertiser name to search the ad library for","example":"skincare"},"adv_biz_ids":{"type":"string","required":false,"note":"advertiser business id, to pin the search to one advertiser instead of a keyword"},"ad_id":{"type":"string","required":false,"note":"fetch one specific ad"},"region":{"type":"string","required":false,"note":"ISO country code or 'all' (the default). TikTok's library is a DSA transparency database, so coverage is EU/EEA/UK-centric — and per the actor's own input schema it REJECTS region=US; pass 'all' to include US ads","example":"all"},"query_type":{"type":"string","required":false,"note":"which field `search` is matched against: '1' = advertiser name (the actor's DEFAULT), '0' = keyword. A keyword passed without query_type:'0' is matched as an advertiser name and finds nothing","example":"1"},"start_date":{"type":"string","required":false,"note":"YYYY-MM-DD","example":"2026-06-01"},"end_date":{"type":"string","required":false,"note":"YYYY-MM-DD"},"sort":{"type":"string","required":false},"limit":{"type":"integer","required":false,"note":"results to return; pair it with maxTotalChargeUsd","example":50},"offset":{"type":"integer","required":false,"example":0}},"bodyType":"json","note":"returns creative content, advertiser, dates, audience reach and targeting as TikTok discloses them in the Commercial Content Library. Community actor, not an official TikTok surface — the only route to this capability in the catalog, and the one most likely to break upstream, so check the actor's run history before relying on it"},"test_request":{"queryParams":{"maxItems":1,"maxTotalChargeUsd":0.05,"timeout":90},"body":{"search":"nike","region":"all","query_type":"1","limit":1,"offset":0}},"capability":"tiktok-ads.library.search","capability_description":"Search publicly running ads by advertiser","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":{"samples":481,"decided":460,"ok_rate":0.9978,"p50_ms":24846,"p95_ms":56006,"last_ok_days":1,"hit_rate":null,"hit_samples":0}},{"id":"adyntel.tiktok-ads.library.search.company","provider":"adyntel","provider_display":"Adyntel","name":"Find a company's TikTok ads","summary":"Return TikTok brand ads, with optional influencer ads.","method":"POST","path":"/tiktok","scope":"any_account","tier":"core","kind":"data","domain":"advertising","call_template":"treg call adyntel.tiktok-ads.library.search.company --method POST --data '{\"company_domain\":\"gymshark.com\"}'","cost":{"type":"per_success","value":1,"currency":"credit","per":1,"unit":"page","source":"observed","source_url":"https://www.adyntel.com/facebook-ads-scraper","checked":"2026-09-22","confidence":"verified","note":"One credit for brand ads; influencer_ads=true costs one extra credit. HTTP 204 misses are free.","settle":"modifiers","modifiers":{"influencer_ads":{"location":"body","when":"truthy","add_credits":1}},"usd":0.011},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":204,"means":"No matching ads were returned."},"status":null,"status_note":null,"superseded_by":null,"verified":"2026-09-22","added":"2026-09-23","docs_url":"https://www.adyntel.com/tiktok-ads-scraper/","has_example":true,"input":{"body":{"company_domain":{"type":"string","required":true,"example":"gymshark.com"},"influencer_ads":{"type":"boolean","required":false,"default":false,"note":"Adds one credit when true."}}},"body_allowlist":true,"test_request":{"body":{"company_domain":"gymshark.com"}},"capability":"tiktok-ads.library.search","capability_description":"Search publicly running ads by advertiser","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":{"samples":5565,"decided":5564,"ok_rate":0.9989,"p50_ms":5535,"p95_ms":27120,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"tikhub.x.tiktok-ads-search-ads","provider":"tikhub","provider_display":"TikHub","name":"Search TikTok ads","summary":"Tiktok: Search ads","method":"POST","path":"/api/v1/tiktok/ads/search_ads","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call tikhub.x.tiktok-ads-search-ads --method POST --data '{\"limit\":5}'","cost":{"type":"per_call","value":0.001,"currency":"USD","per":1,"unit":"call","source":"rate_card_api","source_url":"https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info","checked":"2026-07-28","confidence":"verified","usd":0.001},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"","has_example":true,"input":{"body":{"objective":{"type":"integer","required":false,"note":"广告目标类型/Ad objective (1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售)","example":1},"like":{"type":"integer","required":false,"note":"表现排名/Performance rank (1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80%)","example":1},"period":{"type":"integer","required":false,"note":"Time period in days. Allowed values 7 | 30 | 120 | 180 (TikHub OpenAPI: e.g. 7, 30, 120, 180 days). Other integers fail Creative Center nested validation.","example":180},"industry":{"type":"string","required":false,"note":"Industry ID"},"keyword":{"type":"string","required":false,"note":"Search keyword"},"page":{"type":"integer","required":false,"note":"Page number","example":1},"limit":{"type":"integer","required":false,"note":"Items per page. Default 20. Prefer limit ≤ 20 — live Creative Center validation has rejected values above 20 (30/50) even though some OpenAPI text says max 50.","example":20},"order_by":{"type":"string","required":false,"note":"Sort by (for_you, likes)","example":"for_you"},"country_code":{"type":"string","required":false,"note":"Country code. May not always filter results the way agents expect (some codes, e.g. PH, have been observed appearing ignored).","example":"US"},"ad_format":{"type":"integer","required":false,"note":"广告格式/Ad format (1:视频)","example":1},"ad_language":{"type":"string","required":false,"note":"Ad language","example":"en"},"search_id":{"type":"string","required":false,"note":"Search ID (optional)"}}},"test_request":{"body":{"limit":5}},"capability":"tiktok-ads.library.search","capability_description":"Search publicly running ads by advertiser","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":{"samples":6816,"decided":4956,"ok_rate":1.0,"p50_ms":1223,"p95_ms":4143,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"scrapecreators.x.v1-tiktok-ad-library-search","provider":"scrapecreators","provider_display":"ScrapeCreators","name":"Search TikTok ad library by keyword or advertiser","summary":"Searches TikTok's public Ads Library by advertiser name or keyword.","method":"GET","path":"/v1/tiktok/ad-library/search","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call scrapecreators.x.v1-tiktok-ad-library-search --query query=Anysphere","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","reported_charge":{"path":"credits_charged","unit":"credit"},"source":"rate_card_api","source_url":"https://docs.scrapecreators.com/openapi.json","checked":"2026-07-28","confidence":"verified","usd":0.00188},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"https://docs.scrapecreators.com/tiktok/ad-library/search","has_example":false,"input":{"queryParams":{"query":{"type":"string","required":true,"note":"Advertiser name or keyword to search for.","example":"Anysphere"},"cursor":{"type":"string","required":false,"note":"Opaque cursor returned from the previous response.","example":"cursor from previous response"}}},"test_request":{"queryParams":{"query":"Anysphere"}},"capability":"tiktok-ads.library.search","capability_description":"Search publicly running ads by advertiser","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":{"samples":13860,"decided":13857,"ok_rate":0.9652,"p50_ms":2329,"p95_ms":9813,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"tikhub.x.tiktok-ads-get-ad-interactive-analysis","provider":"tikhub","provider_display":"TikHub","name":"TikTok ad interactive analysis","summary":"Get ad interactive analysis","method":"POST","path":"/api/v1/tiktok/ads/get_ad_interactive_analysis","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call tikhub.x.tiktok-ads-get-ad-interactive-analysis --method POST --data '{\"material_id\":\"7213258221116751874\"}'","cost":{"type":"per_call","value":0.001,"currency":"USD","per":1,"unit":"call","source":"rate_card_api","source_url":"https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info","checked":"2026-07-28","confidence":"verified","usd":0.001},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"","has_example":true,"input":{"body":{"material_id":{"type":"string","required":true,"note":"Ad material ID","example":"7213258221116751874"},"metric_type":{"type":"string","required":false,"note":"Analysis type (ctr, cvr, clicks, conversion, remain)","example":"remain"},"period_type":{"type":"integer","required":false,"note":"Period type (days)","example":180}}},"test_request":{"body":{"material_id":"7213258221116751874"}},"capability":"tiktok-ads.library.ad.analytics","capability_description":"Get engagement analytics for a public ad","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":null},{"id":"tikhub.x.tiktok-ads-get-ad-keyframe-analysis","provider":"tikhub","provider_display":"TikHub","name":"TikTok ad keyframe analysis","summary":"Get ad keyframe analysis","method":"POST","path":"/api/v1/tiktok/ads/get_ad_keyframe_analysis","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call tikhub.x.tiktok-ads-get-ad-keyframe-analysis --method POST --data '{\"material_id\":\"7213258221116751874\"}'","cost":{"type":"per_call","value":0.001,"currency":"USD","per":1,"unit":"call","source":"rate_card_api","source_url":"https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info","checked":"2026-07-28","confidence":"verified","usd":0.001},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"","has_example":true,"input":{"body":{"material_id":{"type":"string","required":true,"note":"Ad material ID","example":"7213258221116751874"},"metric":{"type":"string","required":false,"note":"Analysis metric (retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt)","example":"retain_ctr"}}},"test_request":{"body":{"material_id":"7213258221116751874"}},"capability":"tiktok-ads.library.ad.analytics","capability_description":"Get engagement analytics for a public ad","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":null},{"id":"tikhub.x.tiktok-ads-get-ad-percentile","provider":"tikhub","provider_display":"TikHub","name":"TikTok ad percentile metrics","summary":"Get ad percentile data","method":"POST","path":"/api/v1/tiktok/ads/get_ad_percentile","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call tikhub.x.tiktok-ads-get-ad-percentile --method POST --data '{\"material_id\":\"7213258221116751874\"}'","cost":{"type":"per_call","value":0.001,"currency":"USD","per":1,"unit":"call","source":"rate_card_api","source_url":"https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info","checked":"2026-07-28","confidence":"verified","usd":0.001},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"","has_example":true,"input":{"body":{"material_id":{"type":"string","required":true,"note":"Ad material ID","example":"7213258221116751874"},"metric":{"type":"string","required":false,"note":"Analysis metric (ctr_percentile, time_attr_conversion_rate_percentile, click_cnt_percentile, time_attr_convert_cnt_percentile, show_cnt_percentile)","example":"ctr_percentile"},"period_type":{"type":"integer","required":false,"note":"Time period (days)","example":180}}},"test_request":{"body":{"material_id":"7213258221116751874"}},"capability":"tiktok-ads.library.ad.analytics","capability_description":"Get engagement analytics for a public ad","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":null},{"id":"tikhub.x.tiktok-ads-get-ads-detail","provider":"tikhub","provider_display":"TikHub","name":"TikTok ad details","summary":"Get single ad detail","method":"POST","path":"/api/v1/tiktok/ads/get_ads_detail","scope":"","tier":"extended","kind":"data","domain":"library","call_template":"treg call tikhub.x.tiktok-ads-get-ads-detail --method POST --data '{\"ads_id\":\"7131673574381518849\"}'","cost":{"type":"per_call","value":0.001,"currency":"USD","per":1,"unit":"call","source":"rate_card_api","source_url":"https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info","checked":"2026-07-28","confidence":"verified","usd":0.001},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-07-28","docs_url":"","has_example":true,"input":{"body":{"ads_id":{"type":"string","required":true,"note":"Ad ID","example":"7131673574381518849"}}},"test_request":{"body":{"ads_id":"7131673574381518849"}},"capability":"tiktok-ads.library.ad.detail","capability_description":"Get a public ad's full detail","platform":"tiktok-ads","platform_label":"TikTok Ads","score":20.0361,"observed":null}],"hints":["treg catalog get treg.meta-ads.library.advertiser   # params, cost and an example response","treg.meta-ads.library.advertiser is ROUTED: treg picks among 4 providers (own keys first, then cheapest per hit) and names the one that served; call a child id to choose the provider yourself","treg call treg.meta-ads.library.advertiser --method POST --data '{\"page_id\":\"…\"}'   # run it — key injected server-side","57 more matches — raise limit (max 100)"]}