# Search Events (Google Events via OpenWeb Ninja)

> Search Events (Google Events via OpenWeb Ninja) is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

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.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-events-data/search-events?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-search-events-google-events-via-openweb-ninja-2582b1ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fhRkeZZ_EXDI1rz4QYiEu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-search-events-google-events-via-openweb-ninja-2582b1ab
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-search-events-google-events-via-openweb-ninja-2582b1ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)