# Eventbrite Places API Documentation

<p><strong>Eventbrite Places API Documentation</strong> Search places by name. Each place has the id, name, parent country or region, place type (region, locality, borough, neighbourhood), slug, coordinates, parent id and the number of upcoming events. Use the id as place_id in the search. One page of up to 50 places is returned.</p>

- **Documentation:** [https://scrappa.co/docs/eventbrite-api/eventbrite_places](https://scrappa.co/docs/eventbrite-api/eventbrite_places)
- **API group:** Eventbrite API
- **Endpoint:** `GET https://scrappa.co/api/eventbrite/places`

## 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 | Place name, e.g. berlin. |

## Example response

```json
{
    "data": {
        "places": [
            {
                "id": "85682499",
                "name": "Berlin",
                "slug": "germany--berlin--85682499",
                "latitude": "52.524961",
                "subtitle": "Germany",
                "longitude": "13.407003",
                "parent_id": "85633111",
                "place_type": "region",
                "upcoming_event_count": 2324
            },
            {
                "id": "101748799",
                "name": "Berlin",
                "slug": "germany--berlin",
                "latitude": "52.52045",
                "subtitle": "Berlin, Germany",
                "longitude": "13.40732",
                "parent_id": "85633111",
                "place_type": "locality",
                "upcoming_event_count": 2323
            }
        ],
        "pagination": {
            "page": 1,
            "has_more": false,
            "page_size": 50,
            "page_count": 1,
            "total_results": 20
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "places"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing, invalid or not supported by this endpoint. This response is not billable. |
| 502 | Unexpected Upstream Format | Eventbrite answered in a format this API does not understand. This response is not billable. |
| 503 | Upstream Unavailable | Eventbrite did not answer after several attempts. This response is not billable. |

## 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)
