{"uid":"cap_fhRkeZZ_EXDI1rz4QYiEu","slug":"agents-openwebninja-com-search-events-google-events-via-openweb-ninja-2582b1ab","name":"Search Events (Google Events via OpenWeb Ninja)","description":"Search for local and online events in real-time, as shown on Google's Events feature inside Google Search results. Use an event-style query (e.g. *events in austin* or *concerts in new york this weekend*): Google only renders events for queries it reads as an events search, so a plain query may return an empty list. Google shows a fixed set of up to 10 events per query.","url":"https://agents.openwebninja.com/realtime-events-data/search-events?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"date":{"enum":["any","today","tomorrow","week","weekend","next_week","month","next_month"],"type":"string","default":"any","description":"Return events in a certain date / time period. Google no longer offers a date filter, so this acts as a query hint: the matching words (e.g. *this weekend*) are added to the query. It steers results but does not guarantee them."},"query":{"type":"string","example":"Concerts in San-Francisco","description":"Search query / keyword. Phrase it like an events search (e.g. *events in austin*, *concerts in new york this weekend*)."},"is_virtual":{"type":"boolean","default":false,"description":"Prefer virtual / online events. Google no longer offers an online-events filter, so this acts as a query hint (the word *online* is added to the query). It steers results but does not guarantee them."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["event_id","name"],"properties":{"date":{"type":"string","nullable":true,"description":"Google's date label for the event as shown to users."},"link":{"type":"string","nullable":true,"description":"URL of the event on the source publisher."},"name":{"type":"string","nullable":false,"description":"Name / title of the event."},"price":{"type":"string","nullable":true,"description":"Ticket price as shown by Google (e.g. $19). Null when the source publishes no price."},"venue":{"type":"object","nullable":true,"properties":{"cid":{"type":"string","nullable":true,"description":"Google Maps CID of the venue."},"city":{"type":"string","nullable":true,"description":"City of the venue."},"name":{"type":"string","nullable":true,"description":"Name of the venue."},"hours":{"type":"string","nullable":true,"description":"Current opening status of the venue as shown by Google."},"photo":{"type":"string","nullable":true,"description":"Photo URL of the venue."},"state":{"type":"string","nullable":true,"description":"State / region of the venue."},"rating":{"type":"number","nullable":true,"description":"Average Google rating of the venue (0-5)."},"street":{"type":"string","nullable":true,"description":"Street name of the venue address."},"country":{"type":"string","nullable":true,"description":"ISO 3166-1 alpha-2 country code of the venue."},"subtype":{"type":"string","nullable":true,"description":"Primary venue subtype (Google Maps category)."},"summary":{"type":"string","nullable":true,"description":"Google's short venue description."},"website":{"type":"string","nullable":true,"description":"Website of the venue."},"zipcode":{"type":"string","nullable":true,"description":"Postal / zip code of the venue."},"district":{"type":"string","nullable":true,"description":"District / neighborhood of the venue."},"latitude":{"type":"number","nullable":true,"description":"Latitude coordinate of the venue."},"map_link":{"type":"string","nullable":true,"description":"Google Maps page of the venue."},"subtypes":{"type":"array","items":{"type":"string","description":"A single venue subtype label."},"nullable":true,"description":"All venue subtype labels from Google Maps."},"timezone":{"type":"string","nullable":true,"description":"IANA timezone of the venue."},"google_id":{"type":"string","nullable":true,"description":"Google place ID of the venue."},"longitude":{"type":"number","nullable":true,"description":"Longitude coordinate of the venue."},"google_mid":{"type":"string","nullable":true,"description":"Google Knowledge Graph MID of the venue."},"price_range":{"type":"string","nullable":true,"description":"Venue price range (the venue's, not the event's)."},"full_address":{"type":"string","nullable":true,"description":"Full postal address of the venue."},"phone_number":{"type":"string","nullable":true,"description":"Phone number of the venue."},"review_count":{"type":"integer","nullable":true,"description":"Number of Google reviews for the venue."},"street_number":{"type":"string","nullable":true,"description":"Street number of the venue address."}},"description":"Venue details where the event takes place."},"is_free":{"type":"boolean","nullable":true,"description":"False for a priced event, null when no price is published, true when Google labels the event as free."},"category":{"type":"string","nullable":true,"description":"Google's one-line category label for the event."},"end_time":{"type":"string","nullable":true,"description":"Event end datetime in the venue local timezone (YYYY-MM-DD HH:MM:SS)."},"event_id":{"type":"string","description":"Temporary opaque token identifying this result, for use with /event-details. Google can invalidate it at any time, in which case /event-details returns 404 and the search should be re-run. For a permanent identifier use entity_id. Long value, truncated in the example."},"language":{"type":"string","nullable":true,"description":"ISO 639-1 language code of the event details (echoes the language parameter)."},"position":{"type":"integer","nullable":true,"description":"Rank of the event in Google's list (1-10)."},"entity_id":{"type":"string","nullable":true,"description":"Google's entity id of the event (Knowledge Graph mid). Permanent: identical whatever query surfaced the event, so use it as the deduplication / indexing key."},"map_image":{"type":"string","nullable":true,"description":"URL of a static Google Maps tile of the venue location."},"publisher":{"type":"string","nullable":true,"description":"Name of the source publisher hosting the event listing."},"thumbnail":{"type":"string","nullable":true,"description":"URL of the event's thumbnail image."},"info_links":{"type":"array","items":{"type":"object","required":["source","link"],"properties":{"link":{"type":"string","nullable":false,"description":"URL of the info page on the source."},"source":{"type":"string","nullable":false,"description":"Name of the source."}}},"nullable":true,"description":"Additional informational links about the event, when Google shows one."},"is_virtual":{"type":"boolean","description":"Echoes the is_virtual parameter."},"start_time":{"type":"string","nullable":true,"description":"Event start datetime in the venue local timezone (YYYY-MM-DD HH:MM:SS)."},"description":{"type":"string","nullable":true,"description":"Short description of the event."},"end_time_utc":{"type":"string","nullable":true,"description":"Event end datetime in UTC (YYYY-MM-DD HH:MM:SS)."},"ticket_links":{"type":"array","items":{"type":"object","required":["source","link"],"properties":{"link":{"type":"string","nullable":false,"description":"URL of the event on the source."},"source":{"type":"string","nullable":false,"description":"Name of the source."},"fav_icon":{"type":"string","nullable":true,"description":"Favicon URL of the source."}}},"nullable":true,"description":"Ticket / event page link on the source publisher."},"calendar_link":{"type":"string","nullable":true,"description":"Add to Google Calendar URL, includes start, end and timezone."},"start_time_utc":{"type":"string","nullable":true,"description":"Event start datetime in UTC (YYYY-MM-DD HH:MM:SS)."},"directions_link":{"type":"string","nullable":true,"description":"Google Maps directions URL to the venue. Long value, truncated in the example."},"publisher_domain":{"type":"string","nullable":true,"description":"Domain of the source publisher."},"publisher_favicon":{"type":"string","nullable":true,"description":"URL of the source publisher's favicon."},"date_human_readable":{"type":"string","nullable":true,"description":"Human-readable event start date and time as displayed by Google."},"end_time_precision_sec":{"type":"integer","nullable":true,"description":"Always null: Google no longer provides time precision. Kept for backward compatibility."},"start_time_precision_sec":{"type":"integer","nullable":true,"description":"Always null: Google no longer provides time precision. Kept for backward compatibility."}}},"description":"Array of event results, in the order Google shows them (up to 10)."},"status":{"type":"string","description":"The status of the response"},"parameters":{"type":"object","properties":{"date":{"type":"string","description":"The date parameter."},"query":{"type":"string","description":"The search query parameter."},"is_virtual":{"type":"boolean","description":"The is_virtual parameter, echoed when provided."}}},"request_id":{"type":"string","description":"A unique identifier for the request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_cSIJMg4vsXQKQSjkY4-Va","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Searches for local and online events in real-time as shown on Google's Events feature, returning up to 10 events with venue details, dates, prices, and links.","exampleAgentPrompt":"Can you find me concerts or live music events happening in San Francisco this weekend? Show me what's available with ticket prices and venue info.","exampleUseCases":[{"title":"Weekend concert planning in a city","prompt":"What concerts are happening in Nashville this weekend? I want to see ticket prices and venue details so I can pick one to go to."},{"title":"Discovering virtual online events","prompt":"Find me online events or virtual workshops happening this week — something I can attend from home."},{"title":"Local festival discovery for travel","prompt":"I'm visiting Austin next month — what festivals or local events will be going on there? Give me the dates and venues."}],"resultDescription":"Returns an array of up to 10 event objects, each containing the event name, Google's date label, a link to the event page on the source publisher, ticket price (if available), and detailed venue information including name, address, city, state, country, coordinates, Google Maps CID, rating, photo, opening hours, website, and a short description. Also includes event thumbnails, tags/categories, and a description snippet where available.","failureModes":["Empty results list if query is not phrased as an events-style search (plain keyword queries may return no events)","Date filter is a query hint only — does not guarantee events within that timeframe","Virtual/online filter is a query hint only — may still return in-person events","Google caps results at ~10 events per query regardless of how many exist","Venue details (rating, hours, coordinates) may be null if Google Maps data is unavailable","Ticket prices may be null if the source publisher does not list them","Payment/auth failure if credits are exhausted or the proxy rejects the request"],"whenToPreferThis":"Use this endpoint when you need real-time event discovery data as shown on Google's Events SERP feature — especially for local, city-specific, or weekend event searches. It's the right choice when you need rich venue metadata alongside event listings. Prefer it over generic web search when you specifically want structured event data (name, date, venue, price) rather than raw links. Note its limitation: queries must be phrased in event-search style, and results are capped at 10 per query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:19.771Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-search-events-google-events-via-openweb-ninja-2582b1ab"}