{"stats":{"calls7d":0,"successRate":null,"avgMs":null,"reviews":0,"usefulRate":null},"id":"p/apify.meta-ads.library.search","kind":"provider","name":"apify_meta-ads_library_search","description":"Scrape the Meta ad library by Page or search URL. Scrape publicly running Facebook and Instagram ads for a page or Ad Library search (Apify · Meta Ads (Facebook & Instagram))","tags":["meta-ads","advertising","apify","library","search","data"],"method":"POST","path":"/v1/p/apify.meta-ads.library.search","url":"https://toll402.dev/v1/p/apify.meta-ads.library.search","specUrl":"https://toll402.dev/v1/spec/p/apify.meta-ads.library.search","price":"$0.00625","priceUsd":0.00625,"available":true,"inputSchema":{"type":"object","properties":{"startUrls":{"type":"array","description":"[{\"url\": \"…\"}] — either a Facebook Page URL or a full Meta Ad Library search URL (facebook.com/ads/library/?q=…&country=US)","examples":[[{"url":"https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&q=project%20management"}]]},"resultsLimit":{"type":"integer","description":"max ads PER URL; unlimited if omitted, which is how runs get expensive","examples":[50]},"activeStatus":{"type":"string","description":"\"active\" | \"inactive\" | \"\" for both","examples":["active"]},"isDetailsPerAd":{"type":"boolean","description":"true adds Instagram data, spend info and EU reach/targeting per ad — richer than Meta's own API, and slower","examples":[false]},"includeAboutPage":{"type":"boolean","description":"true adds the advertiser's address, admin country and page history"},"onlyAdsNewerThan":{"type":"string","description":"YYYY-MM-DD or a relative phrase like \"2 months\"","examples":["2026-06-01"]},"onlyAdsOlderThan":{"type":"string"},"onlyTotal":{"type":"boolean","description":"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","examples":[false]},"enrichWithEcommerceData":{"type":"boolean","description":"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","enum":[false],"examples":[false]}},"additionalProperties":true,"required":["startUrls"],"description":"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"},"example":{"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},"meta":{"provider":"Apify","providerSlug":"apify","providerDocs":"https://docs.apify.com/api/v2","providerPricing":"https://apify.com/pricing","providerLogo":"https://www.google.com/s2/favicons?domain=apify.com&sz=64","platform":"meta-ads","platformLabel":"Meta Ads (Facebook & Instagram)","category":"Advertising","capability":"meta-ads.library.search","upstreamMethod":"POST","upstreamPriceUsd":0.005,"pricing":"per_result","pricingNote":"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'","verified":"2026-09-26","docs":"https://apify.com/apify/facebook-ads-scraper","calls":0,"successRate":null,"via":"treg"}}