{"uid":"cap_wehgQQmhlNJ83yJOQScWt","slug":"scopeapi-facebook-ads-search-eda253cd","name":"ScopeAPI Facebook Ads Search","description":"37 paid REST endpoints: Facebook social & ads intelligence, Amazon e-commerce data, job market intelligence. Pay per call via x402 micropayments (USDC on Base).","url":"https://scopepay.vercel.app/api/facebook/ads/search","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":{"q":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{},"source":"ScopeAPI"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.75","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.75/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AdVC-mnmp_c7YjwU-c6u9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.75","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and retrieve Facebook ad intelligence data by keyword query","exampleAgentPrompt":"Search ScopeAPI's Facebook ads intelligence for ads related to 'protein powder' — I want to see what ads are currently running on Facebook for that keyword.","exampleUseCases":[{"title":"Competitive intelligence for fitness brands","prompt":"Check what ads our competitors are running on Facebook right now for 'weight loss supplements' — I need to see their creative angles and messaging."},{"title":"Market research for product launches","prompt":"Search Facebook ads intelligence for 'smart water bottles' to find out what advertising strategies are working in that space before we launch."},{"title":"Ad creative inspiration by category","prompt":"Look up Facebook ads running for 'vegan protein snacks' so our creative team can see what ad formats and copy styles are resonating with that audience."}],"resultDescription":"Returns a JSON object with a 'data' field containing Facebook ad search results matching the query keyword, along with a 'source' field identifying ScopeAPI. The data likely includes ad creatives, advertisers, and campaign metadata found on Facebook for the given search term.","failureModes":["Missing required 'q' query parameter returns an error or empty result","Payment not completed via x402 micropayment returns 402 Payment Required","Invalid or expired USDC payment on Base network causes authorization failure","Facebook data unavailable for obscure or very new keywords returns empty data object","Rate limiting or upstream Facebook data source unavailability causes 503 errors"],"whenToPreferThis":"Choose this endpoint when you need to search Facebook ad intelligence by keyword and want pay-per-call access without a subscription. Ideal for competitive ad research, marketing analysis, or discovering what ads are running on Facebook for specific topics. Best when you need ad data programmatically via micropayments on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:37:20.372Z","isFirstParty":false}