{"uid":"cap_lcUPucVPzq2yaf7Ci4y0P","slug":"ragradar-grid-facebook-ads-search-ada0914f","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://scrpapi.ragradar.space/api/grid/facebook/ads/search","method":"GET","headers":{},"bodySchema":null,"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_gvNZ27MlziLB2W5AniAh1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.75","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","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 via a paid REST endpoint","exampleAgentPrompt":"Search Facebook ads for 'electric vehicles' so I can see what competitors are currently advertising — pull the ad intelligence data from RagRadar Grid.","exampleUseCases":null,"resultDescription":"A JSON object containing Facebook ads data matching the search query, including ad creatives, advertiser details, and related metadata, sourced from RagRadar Grid's multi-source intelligence platform.","failureModes":["Payment not provided or insufficient USDC balance — 402 Payment Required","Missing required 'q' query parameter — returns error or empty results","No ads found for the given search query — empty data object returned","Rate limiting or quota exceeded — request rejected","Invalid query parameter format — malformed request error"],"whenToPreferThis":"Use this endpoint when you need to search and retrieve Facebook ad intelligence data by keyword for competitive analysis, ad research, or market monitoring, and you are set up to pay per-call in USDC via x402 micropayments. Prefer this over manual Facebook Ad Library browsing when programmatic access is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:01.205Z","isFirstParty":false}