{"slug":"api-socialfetch-dev-v1-facebook-ad-library-ads-search-795e75","title":"Search Facebook Ad Library ads by keyword and filters","host":"api.socialfetch.dev","method":"GET","resource":"https://api.socialfetch.dev/v1/facebook/ad-library/ads/search","category":"search","description":"Search Facebook Ad Library ads by keyword and filters.","price_listed":0.014,"price_asked":0.014,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":306,"reported_calls_30d":3,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"query":"running"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"adType":{"description":"Optional filter for all ads or political and issue ads.","enum":["all","political-and-issue"],"type":"string"},"country":{"description":"Optional country code filter. Use ALL to search all countries.","maxLength":3,"minLength":2,"type":"string"},"cursor":{"description":"Opaque pagination cursor from a previous response.","minLength":1,"type":"string"},"endDate":{"description":"Optional end date filter in YYYY-MM-DD format.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},"mediaType":{"description":"Optional creative media filter.","enum":["all","image","video","meme","image-and-meme","none"],"type":"string"},"query":{"description":"Search query text for Facebook Ad Library ads.","maxLength":4096,"minLength":1,"type":"string"},"searchType":{"description":"Optional keyword matching mode for the search query.","enum":["keyword-unordered","exact-phrase"],"type":"string"},"sortBy":{"description":"Optional sort order for returned ads.","enum":["impressions","most-recent"],"type":"string"},"startDate":{"description":"Optional start date filter in YYYY-MM-DD format.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},"status":{"description":"Optional ad status filter.","enum":["all","active","inactive"],"type":"string"},"trim":{"description":"When true, returns a smaller response with fewer fields.","type":"boolean"}},"required":["query"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.014,"price_match":true,"latency_ms":306,"error":null}],"description_full":"Search Facebook Ad Library ads by keyword and filters.","last_updated":"2026-09-22T01:14:28.227Z","schemes":["exact"]}