{"uid":"cap_5aoCMuB0GUvf4_khc-Avf","slug":"gedx402-social-facebook-ad-library-search-f0e4f2f9","name":"GEDX402 Social – Facebook Ad Library Search","description":"SociaVault API proxy — facebook-ad-library-search. 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/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"trim":{"type":"boolean"},"query":{"type":"string"},"cursor":{"type":"string"},"status":{"type":"string"},"ad_type":{"type":"string"},"country":{"type":"string"},"sort_by":{"type":"string"},"end_date":{"type":"string"},"media_type":{"type":"string"},"start_date":{"type":"string"},"search_type":{"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_gwh6W1ShDriM43qGNuzlH","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":"Search Facebook's Ad Library for active or inactive ads by keyword, country, ad type, date range, and media type via the SociaVault proxy.","exampleAgentPrompt":"Search the Facebook Ad Library for active video ads related to 'electric vehicles' running in the US between January 1 2024 and June 30 2024, sorted by relevance.","exampleUseCases":null,"resultDescription":"A JSON object with a 'data' field containing matching Facebook ad records from the Ad Library, a 'success' boolean, and a 'provider' string set to 'sociavault'. Ads include metadata such as creative details, status, and targeting. Results may include a cursor for pagination.","failureModes":["No ads found matching the query — empty data object returned with success: true","Invalid country code or ad_type value — may return error or empty results","Cursor expired or malformed — pagination fails","Payment not processed — x402 payment required before response is delivered","Rate limit or upstream Facebook Ad Library unavailability — upstream error propagated"],"whenToPreferThis":"Use this endpoint when you need programmatic access to the Facebook Ad Library to research competitor ads, monitor political advertising, or gather creative intelligence by keyword and country filter — especially when you want pay-per-call pricing via x402 without a monthly subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-07-17T17:54:47.036Z","lastSuccessfullyRanAt":"2026-07-17T17:54:47.036Z","lastHealthCheckAt":"2026-10-19T18:39:42.742Z","isFirstParty":false,"canonicalSlug":"gedx402-social-facebook-ad-library-search-f0e4f2f9"}