{"uid":"cap_uutSYXyjp3SbaafQJv6f4","slug":"stablesocial-facebook-ad-library-company-ads-scraper-46ca1fe4","name":"StableSocial Facebook Ad Library — Company Ads Scraper","description":"Scrape Creators · Facebook — Company Ads","url":"https://socialx402.com/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_eQXDl4R0hAkJF8XZ403ok","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 ads run by a specific company from the Facebook Ad Library, returning structured ad creative and metadata.","exampleAgentPrompt":"Pull all the current Facebook ads running for Nike from the Facebook Ad Library — I want to see the ad creatives, copy, and how long each ad has been active.","exampleUseCases":[{"title":"Competitor ad creative research","prompt":"Scrape all the Facebook ads currently running for Coca-Cola from the Ad Library so I can analyze what messaging and visuals they're using in their campaigns right now."},{"title":"Brand ad monitoring for a client","prompt":"Fetch the latest Facebook Ad Library ads for my client's competitor, Peloton, so I can put together a report on their current Facebook advertising activity including ad copy and status."},{"title":"Market research on advertiser tactics","prompt":"Get me all the active Facebook ads from Apple's company page in the Ad Library — I want to see every ad they're running, including the creative details and how long they've been live."}],"resultDescription":"Returns a structured list of ads from the Facebook Ad Library associated with the specified company, including ad creatives (images/video thumbnails), ad copy/headline text, active/inactive status, estimated impressions or spend range, ad start and end dates, and targeting details where available.","failureModes":["Company not found in Facebook Ad Library — returns empty result or 404-equivalent","Invalid or unrecognized company identifier — returns error","Facebook Ad Library rate limiting or access restrictions — may return partial data","Company has no active or archived ads — returns empty array","Network timeout if Facebook's Ad Library is slow to respond"],"whenToPreferThis":"Choose this endpoint when you need to programmatically extract ads run by a specific company from the Facebook Ad Library without manual browsing. It is ideal for competitive intelligence, ad monitoring workflows, or market research where you need structured ad data at scale. Prefer this over manual Ad Library searches when you need automation, structured output, or integration into a larger data pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:33:45.416Z","isFirstParty":false}