{"uid":"cap_dpxuB2mKQnd0Bu5RgBSYr","slug":"gedx402-social-facebook-ad-library-company-ads-10a6b285","name":"GEDX402 Social — Facebook Ad Library Company Ads","description":"SociaVault API proxy — facebook-ad-library-company-ads. Query/body matches https://docs.sociavault.com/api-reference/openapi.json. GET/POST per route; x402 per call. $0.014 USDC per request.","url":"https://social.gedx402.com/v1/sociavault/facebook-ad-library/company-ads?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"trim":{"type":"boolean"},"cursor":{"type":"string"},"pageId":{"type":"string"},"status":{"type":"string"},"country":{"type":"string"},"end_date":{"type":"string"},"language":{"type":"string"},"media_type":{"type":"string"},"start_date":{"type":"string"},"companyName":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"success":true,"provider":"sociavault"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"0.50","reviews":1,"stars":"1.3","state":"rated"},"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_SGw1i3g8hwiZSINiOVZ6N","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":"Retrieves Facebook Ad Library ads for a specific company, filtered by country, date range, media type, language, and ad status via SociaVault proxy.","exampleAgentPrompt":"Pull all active Facebook ads for Nike in the US from January 1 2024 to June 30 2024, including image and video media types, from the SociaVault Facebook Ad Library proxy.","exampleUseCases":null,"resultDescription":"A JSON object with a data field containing Facebook Ad Library ad records for the specified company, including ad creatives, targeting details, and status information, plus a success flag and provider attribution.","failureModes":["Invalid or unknown pageId returns empty data or error","Invalid country code returns no results","Date range with no ads returns empty data array","Malformed cursor causes pagination failure","Missing required companyName or pageId may return an error or empty result","Network or upstream Facebook Ad Library outage causes proxy failure","Payment failure (x402) blocks the request entirely"],"whenToPreferThis":"Use this endpoint when you need to programmatically query the Facebook Ad Library for a specific company's ads and want pay-per-call pricing via x402 micro-payments, especially for competitive ad research, brand monitoring, or ad intelligence workflows where you need filtering by country, date, language, or media type.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-07-17T17:55:16.393Z","lastSuccessfullyRanAt":"2026-07-17T17:55:16.393Z","lastHealthCheckAt":"2026-10-21T18:30:18.927Z","isFirstParty":false,"canonicalSlug":"gedx402-social-facebook-ad-library-company-ads-10a6b285"}