{"uid":"cap_Qh_8kWa3RVV0Da-1x2xH4","slug":"socialfetch-facebook-ad-library-list-company-ads-a0e23355","name":"SocialFetch Facebook Ad Library – List Company Ads","description":"List ads a company or Page is running in the Facebook Ad Library.","url":"https://api.socialfetch.dev/v1/facebook/ad-library/companies/ads","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor from a previous response."},"pageId":{"type":"string","maxLength":4096,"minLength":1,"description":"Facebook page id when you have it instead of a company name."},"sortBy":{"enum":["impressions","most-recent"],"type":"string","description":"Optional sort order for returned ads."},"status":{"enum":["all","active","inactive"],"type":"string","description":"Optional ad status filter."},"country":{"type":"string","maxLength":3,"minLength":2,"description":"Optional country code filter. Use ALL to search all countries."},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional end date filter in YYYY-MM-DD format."},"language":{"type":"string","maxLength":8,"minLength":2,"description":"Optional language code filter."},"mediaType":{"enum":["all","image","video","meme","image-and-meme","none"],"type":"string","description":"Optional creative media filter."},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional start date filter in YYYY-MM-DD format."},"companyName":{"type":"string","maxLength":4096,"minLength":1,"description":"Company or page name to search when you do not have a page id."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tIVUoFvV5VgxxQSw1bmDg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"List all ads a company or Facebook Page is currently or previously running, pulled from the Facebook Ad Library, with filtering by status, country, date range, media type, and language.","exampleAgentPrompt":"Show me all active Facebook ads that Nike is currently running in the US, sorted by impressions — I want to see what image and video creatives they're using right now.","exampleUseCases":null,"resultDescription":"A paginated list of ads associated with the specified company or Facebook Page, including ad creatives, media type, status (active/inactive), impression data, and a nextCursor for fetching additional pages.","failureModes":["Company name not found in Facebook Ad Library — returns empty results","Invalid page ID — returns error or empty list","Unsupported country code — validation error","Date range with endDate before startDate — validation error","Rate limiting or payment failure — HTTP 402 or 429","Cursor expired or invalid — pagination error"],"whenToPreferThis":"Use this endpoint when you need to enumerate all ads (active, inactive, or both) associated with a specific company or Facebook Page, especially for competitive research, ad monitoring, or compliance checks. Prefer over manual Facebook Ad Library browsing when you need structured, filterable, paginated data programmatically. Use pageId for precision when you already have the Facebook page identifier; use companyName for discovery-style searches.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:53:20.907Z","isFirstParty":false}