# Google Events Search

Search the events pack Google shows for an event query (for example "concerts in austin") and get up to ten events with date, address, venue, description, price and ticket links. The response uses the field names of the SerpApi google_events engine. The htichips filter is approximated with query words, and uule is accepted but not sent. start above 0 returns an empty events_results because the pack holds one page.

- **Documentation:** [https://scrappa.co/docs/google-events-api/google_events_search](https://scrappa.co/docs/google-events-api/google_events_search)
- **API group:** Google Events API
- **Endpoint:** `GET https://scrappa.co/api/google-events`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | Event query, for example "concerts in austin" |
| `hl` | string | No | Interface language code (e.g., en, de, pt-br) |
| `gl` | string | No | Country code (e.g., us, gb) |
| `location` | string | No | Place name added to the query when the query does not contain it. Cannot be combined with uule. |
| `uule` | string | No | Encoded Google location, echoed in search_parameters and not sent. Cannot be combined with location. |
| `htichips` | string | No | Comma separated filters: date:today, date:tomorrow, date:week, date:weekend, date:next_week, date:month, date:next_month, event_type:Virtual-Event. Applied as query words (best effort). |
| `start` | integer | No | Zero-based offset. The events pack has one page, so start above 0 returns no events. Default: 0. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google-events?q=concerts+in+austin&hl=en&gl=us"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "google_events",
        "q": "concerts in austin",
        "gl": "us",
        "hl": "en",
        "start": 0
    },
    "search_information": {
        "events_results_state": "Results for exact spelling"
    },
    "events_results": [
        {
            "position": 1,
            "title": "FOSTER THE PEOPLE - AUSTIN, TX",
            "date": {
                "start_date": "Oct 16",
                "when": "Fri, Oct 16, 7:00 PM",
                "start_time": "2026-10-17T00:00:00Z",
                "end_time": "2026-10-17T02:30:00Z"
            },
            "address": [
                "Moody Amphitheater",
                "1401 Trinity St, Austin, TX 78701"
            ],
            "link": "https://www.google.com/search?q=FOSTER%20THE%20PEOPLE%20-%20AUSTIN%2C%20TX&ibp=htl;events#fpstate=tldetail&htidocid=%2Fg%2F11z9qyzjc_",
            "event_location_map": {
                "link": "https://www.google.com/maps/search/?api=1&query=Moody%20Amphitheater%2C%201401%20Trinity%20St%2C%20Austin%2C%20TX%2078701"
            },
            "description": "Buy Foster The People tickets at Moody Amphitheater in Austin, TX on 10/16/26 (Fri) at 8:00PM.",
            "ticket_info": [
                {
                    "source": "Ticketmaster",
                    "link": "https://www.ticketmaster.com/foster-the-people-good-mourning-sunshine-austin-texas-10-16-2026/event/3A00649CBDB12FBE",
                    "link_type": "tickets"
                },
                {
                    "source": "moodyamphitheater.com",
                    "link": "https://www.moodyamphitheater.com/",
                    "link_type": "more info"
                }
            ],
            "venue": {
                "name": "Moody Amphitheater",
                "rating": 4.5,
                "reviews": 1360,
                "link": "https://www.google.com/search?q=Moody+Amphitheater&ludocid=6353176868970403958"
            },
            "price": "$43",
            "extracted_price": 43,
            "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS1QH8-u7-5kupJOAjj_KsgLFtP_vNF5ZQd_-Ghi16nDTyhYClVFnD-60Ao6Cgi56D47925sKFxqHZM_uw"
        }
    ],
    "pagination": {
        "current_page": 1,
        "start": 0
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | One or more query parameters failed validation. |
| 503 | Events Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)