{"uid":"cap_AUgrZ9FfXzzDpAnlKhZZX","slug":"ragradar-grid-facebook-search-b50ef06c","name":"RagRadar Grid — Facebook 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/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.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qu_m39xibvwRucEtxtuIe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Facebook for social and ads intelligence data using a keyword query via pay-per-call micropayment REST API","exampleAgentPrompt":"Search Facebook for posts and pages about 'organic skincare brands' and show me what social and ads intelligence comes back from RagRadar Grid.","exampleUseCases":[{"title":"Monitor competitor brand mentions online","prompt":"Search Facebook for posts and ads mentioning our main competitor 'BeautyTech Pro' and show me what social intelligence and ad activity you find about them."},{"title":"Find influencers in sustainable fashion niche","prompt":"Search Facebook for posts and pages related to 'sustainable fashion influencers' and pull back any social signals or engagement data about who's talking about eco-friendly clothing."},{"title":"Track product launch campaign performance","prompt":"Search Facebook for ads and posts mentioning our new product launch 'GreenClean Detergent' and get me the intelligence on how it's being discussed and promoted right now."}],"resultDescription":"Returns a JSON object with a 'data' field containing Facebook search results (posts, pages, ads, profiles, or other social content matching the query) and a 'source' field indicating 'RagRadar Grid'. The exact shape of 'data' varies but reflects Facebook social and advertising intelligence for the given search term.","failureModes":["Missing required 'q' query parameter — returns an error or empty result","Payment not processed (x402 micropayment failure) — returns HTTP 402 requiring USDC payment on Base","Invalid or empty search query — may return empty data object","Rate limit exceeded — returns HTTP 429 or payment-related rejection","Facebook data unavailable for query — returns empty data object","Network or upstream Facebook data source outage — returns HTTP 500 or error body"],"whenToPreferThis":"Use this endpoint when you need to search Facebook for social signals, brand mentions, page data, or advertising intelligence and are willing to pay $0.50 USDC per call via x402 micropayments. Prefer this over manual scraping or other social APIs when you need fast, programmatic access to Facebook public data without managing OAuth credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:37:19.227Z","isFirstParty":false}