{"uid":"cap_x2Z6Q-Oqm96fI9xFkBY9W","slug":"stablesocial-facebook-ad-library-company-ads-scraper-42596c28","name":"StableSocial Facebook Ad Library — Company Ads Scraper","description":"Scrape Creators · Facebook — Company Ads","url":"https://stablesocial.dev/api/sc/facebook/adLibrary/company/ads","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cursor":{"type":"string","description":"Cursor to paginate through results"},"pageId":{"type":"string","description":"The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName"},"status":{"enum":["ALL","ACTIVE","INACTIVE"],"type":"string","description":"Status of the ad. Defaults to ACTIVE."},"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."},"sort_by":{"enum":["total_impressions","relevancy_monthly_grouped"],"type":"string","description":"Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions."},"end_date":{"type":"string","description":"End date to search for. Format: YYYY-MM-DD"},"language":{"type":"string","description":"Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc"},"media_type":{"enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"],"type":"string","description":"Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme."},"start_date":{"type":"string","description":"Start date to search for. Format: YYYY-MM-DD"},"companyName":{"type":"string","description":"The name of the company. Can either use this or pageId"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j3LhaSlj46wBU9BRroKBO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and returns ads run by a specific company from the Facebook Ad Library","exampleAgentPrompt":"Pull all the current Facebook ads from Nike's company page using the Facebook Ad Library so I can see what campaigns they're actively running.","exampleUseCases":[{"title":"Competitor ad creative research","prompt":"Grab all the Facebook ads that Spotify is currently running from the Ad Library — I want to see their ad creatives and messaging to understand their current marketing strategy."},{"title":"Brand advertising audit","prompt":"Can you scrape all Facebook ads associated with the company 'Airbnb' from the Facebook Ad Library? I need to audit what they've been advertising recently."},{"title":"Agency client campaign monitoring","prompt":"Fetch the latest Facebook Ad Library ads for my client 'LocalBrewCo' so I can check whether their paid social campaigns are still live and what's currently running."}],"resultDescription":"Returns a list of ads associated with the specified company from the Facebook Ad Library, including ad creatives, copy, active/inactive status, estimated spend ranges, impressions data, date ranges the ads ran, and targeting details where available.","failureModes":["Company not found in Facebook Ad Library — returns empty results or error","Invalid company name or page ID — may return unrelated ads or no results","Rate limiting or access restrictions from Facebook's Ad Library API","Ads data may be incomplete for political or issue-based ad categories","Endpoint may return stale cached data if the ad library hasn't been recently indexed"],"whenToPreferThis":"Use this endpoint when you need structured ad data for a specific company from Facebook's Ad Library, particularly for competitive intelligence, ad creative research, or campaign monitoring. It is preferable to manual browsing of the Facebook Ad Library UI and useful for agents that need programmatic access to Facebook advertising data at scale. Choose this over general web scraping tools when you specifically need Facebook company ad data in a structured format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:59:49.640Z","isFirstParty":false}