{"uid":"cap_4BKt6KhdOSQIY3Q3Zxxsj","slug":"ragradar-grid-facebook-ads-search-0291c541","name":"RagRadar Grid — 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://grid.ragradar.space/api/grid/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":"RagRadar Grid"}},"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_BesAwMR6snfFu7cYhct6l","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 Facebook ads intelligence data by keyword query, returning ad creative and targeting information scraped from Facebook's ad library.","exampleAgentPrompt":"Search Facebook ads for 'electric vehicles' — I want to see what ads are currently running on that topic so I can research competitor messaging.","exampleUseCases":null,"resultDescription":"Returns a JSON object with ad data from Facebook's ad ecosystem matching the search query, sourced from RagRadar Grid's intelligence layer. The response includes a data object with ad results and a source attribution field.","failureModes":["Missing required query parameter q returns an error","Payment not processed or insufficient USDC balance results in 402 response","No ads found for the given keyword returns empty data object","Rate limiting or quota exceeded returns an error response","Invalid or malformed query string may return empty results"],"whenToPreferThis":"Use this endpoint when you need to research what Facebook ads are running for a specific keyword, product, or brand — particularly for competitive intelligence, ad creative research, or market analysis. Prefer this over manual Facebook Ad Library browsing when you need programmatic, pay-per-call access without a Facebook developer account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:33:41.395Z","isFirstParty":false}