{"uid":"cap_r8KKrODPvLb9cu0ekD6cu","slug":"api-direct-facebook-events-search-c7822abe","name":"API Direct – Facebook Events Search","description":"Search for Facebook events by keyword.","url":"https://x402.apidirect.io/v1/facebook/events?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"pages":{"type":"integer","default":1,"maximum":15,"minimum":1,"description":"Number of pages to fetch and merge into one response (1-15). Billed per page."},"query":{"type":"string","maxLength":500,"description":"Search query (max 500 characters)"},"end_date":{"type":"string","description":"Filter events until this date (YYYY-MM-DD)"},"start_date":{"type":"string","description":"Filter events from this date (YYYY-MM-DD)"},"location_id":{"type":"string","maxLength":64,"description":"Facebook location ID from /v1/facebook/locations, used to scope events to that place. Digits only, maximum 64 characters."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__7Cft-2g95JEoVaPcFDkM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for Facebook events by keyword, date range, and location, returning paginated results merged into a single response.","exampleAgentPrompt":"Search Facebook for jazz concerts happening between July 1 and July 31, 2025 — pull back 3 pages of results so we get a good variety.","exampleUseCases":[{"title":"Weekend event discovery in a city","prompt":"Find me Facebook events about food markets or farmers markets happening this weekend, from July 5 to July 6, 2025 — grab 2 pages of results."},{"title":"Conference and meetup research","prompt":"Search Facebook for AI or machine learning meetup events in August 2025, from August 1 through August 31 — I want at least 5 pages of results to make sure I don't miss anything."},{"title":"Holiday event planning","prompt":"Look up Christmas market or holiday festival events on Facebook for December 2025, starting December 1 and ending December 25, and bring back 3 pages."}],"resultDescription":"A merged list of Facebook event records across the requested number of pages, typically including event names, dates, times, locations, descriptions, and links, scoped to the keyword and optional date/location filters provided.","failureModes":["Invalid or missing 'query' parameter returns a validation error","Unrecognized 'location_id' returns empty results or an error","Date strings not in YYYY-MM-DD format may be rejected","Requesting more than 15 pages returns a validation error","Facebook may return sparse results for niche or low-activity queries","Payment failure (402) if insufficient USDC balance — each page costs $0.009 USDC","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Choose this endpoint when you need to surface Facebook-specific public events by keyword — especially for local event discovery, community gatherings, concerts, festivals, or meetups where Facebook is the dominant listing platform. It supports multi-page fetching and date/location filtering, making it suitable for comprehensive event research tasks rather than single-event lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:10.751Z","isFirstParty":false,"canonicalSlug":"api-direct-facebook-events-search-c7822abe"}