{"stats":{"calls7d":0,"successRate":null,"avgMs":null,"reviews":0,"usefulRate":null},"id":"p/scrapecreators.x.v1-facebook-adlibrary-search-ads","kind":"provider","name":"scrapecreators_x_v1-facebook-adlibrary-search-ads","description":"Search Facebook ad library ads by keyword. Searches the Meta Ad Library by keyword and returns matching ads. (ScrapeCreators · Meta Ads (Facebook & Instagram))","tags":["meta-ads","advertising","scrapecreators","library","search","data"],"method":"POST","path":"/v1/p/scrapecreators.x.v1-facebook-adlibrary-search-ads","url":"https://toll402.dev/v1/p/scrapecreators.x.v1-facebook-adlibrary-search-ads","specUrl":"https://toll402.dev/v1/spec/p/scrapecreators.x.v1-facebook-adlibrary-search-ads","price":"$0.00235","priceUsd":0.00235,"available":true,"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for","examples":["running"]},"sort_by":{"type":"string","description":"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 imp","enum":["total_impressions","relevancy_monthly_grouped"],"examples":["total_impressions"]},"search_type":{"type":"string","description":"If you want to search by exact phrase or not","examples":["keyword_unordered"]},"ad_type":{"type":"string","description":"Search for all ads or only political and issue ads","examples":["all"]},"country":{"type":"string","description":"This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.","examples":["ALL"]},"status":{"type":"string","description":"Status of the ad. Defaults to ACTIVE.","examples":["ACTIVE"]},"media_type":{"type":"string","description":"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.","examples":["ALL"]},"start_date":{"type":"string","description":"Impressions start date. Needs to be in YYYY-MM-DD format.","examples":["2025-01-05"]},"end_date":{"type":"string","description":"Impressions end date. Needs to be in YYYY-MM-DD format.","examples":["2025-02-16"]},"cursor":{"type":"string","description":"Cursor to paginate through results","examples":["AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"]},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response","examples":["false"]}},"additionalProperties":true,"required":["query"],"description":"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."},"example":{"query":"running","sort_by":"total_impressions","search_type":"keyword_unordered","ad_type":"all","country":"ALL","status":"ACTIVE","media_type":"ALL","start_date":"2025-01-05","end_date":"2025-02-16","cursor":"AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-","trim":"false"},"meta":{"provider":"ScrapeCreators","providerSlug":"scrapecreators","providerDocs":"https://docs.scrapecreators.com","providerPricing":"https://scrapecreators.com/pricing","providerLogo":"https://www.google.com/s2/favicons?domain=scrapecreators.com&sz=64","platform":"meta-ads","platformLabel":"Meta Ads (Facebook & Instagram)","category":"Advertising","capability":"meta-ads.library.search","upstreamMethod":"GET","upstreamPriceUsd":0.00188,"pricing":"per_call","pricingNote":"","verified":null,"docs":"https://docs.scrapecreators.com/facebook/adLibrary/search/ads","calls":0,"successRate":null,"via":"treg"}}