# Eventbrite API scraper — search live events by city, keyword, category, date and price; pull full event detail (name, date, venue, organizer, ticket price range and image); get an organizer's profile and ALL their upcoming/past events (paginated); and browse a city or category's event listings from Eventbrite.com — no login, no API key

> Search Eventbrite for events by keyword in a city, with optional category, date and free-only filters. Paginated (~20 events/page). Returns each event's name, date, venue with coordinates, image and link.
> ReefAPI engine `eventbrite` · 5 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/eventbrite/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /eventbrite/v1/search — 1 credit
Search Eventbrite for events by keyword in a city, with optional category, date and free-only filters. Paginated (~20 events/page). Returns each event's name, date, venue with coordinates, image and link.

**Parameters:**
- `query` (string, optional) — What to search for — a keyword, artist, topic or event name ('music', 'jazz', 'startup', 'yoga'). Omit to list a city/category's events.
- `location` (string, optional) — Where to search. Use Eventbrite's location slug '<country>--<city>' (e.g. 'united-states--new-york', 'united-kingdom--london', 'ca--san-francisco'), a US '<state-abbr>--<city>' form, or 'online' for online-only events. Defaults to New York.
- `category` (string, optional) — Optional category to narrow results (music, business, food-and-drink, arts, health, sports-and-fitness, community, film-and-media, fashion, hobbies, charity-and-causes, government, science-and-tech, travel-and-outdoor, holiday).
- `date` (enum, optional) — Optional date filter. [one of: today, tomorrow, this-weekend, this-week, this-month]
- `free` (boolean, optional) — Set true to return only free events.
- `page` (integer, optional, default 1) — Result page (~20/page). Page until meta.has_more is false.

**Returns:** events[]{event_id, name, url, start_date, end_date, image, is_online, venue{name, street, city, region, postal_code, country, latitude, longitude}} + meta{page, has_more, next_page}

**Example request body:**
```json
{
  "query": "music",
  "location": "united-states--new-york"
}
```

### POST /eventbrite/v1/detail — 1 credit
Full detail for one event by id or url: name, description, start/end datetime, venue with full address and coordinates, organizer, ticket price range (low/high + currency), availability, language, status and image.

**Parameters:**
- `event_id` (string, optional) — Eventbrite event id (the trailing number in an event URL /e/<name>-tickets-<id>). From a search result's event_id.
- `url` (string, optional) — Alternatively a full Eventbrite event URL.

**Returns:** event{event_id, name, description, start_date, end_date, status, language, image, is_online, venue{...}, organizer{name, url, organizer_id}, offers{low_price, high_price, currency, availability, available_until}}

**Example request body:**
```json
{
  "event_id": "1989917921069"
}
```

### POST /eventbrite/v1/organizer — 1 credit
Profile for an event organizer by id or url: name, bio, verification, avatar, follower count, website and social links, and how many upcoming events they have.

**Parameters:**
- `organizer_id` (string, optional) — Eventbrite organizer id (the number in /o/<name>-<id>). From an event detail's organizer.organizer_id.
- `url` (string, optional) — Alternatively a full Eventbrite organizer URL.

**Returns:** organizer{organizer_id, name, verified, bio, avatar_url, profile_url, followers, website, social_links} + meta{upcoming_events_total}

**Example request body:**
```json
{
  "organizer_id": "105655500371"
}
```

### POST /eventbrite/v1/organizer_events — 1 credit
An organizer's events, paginated (30/page). Choose upcoming (default) or past. Returns each event with name, start/end datetime, venue, category, price range and link.

**Parameters:**
- `organizer_id` (string, required) — Eventbrite organizer id to list events for.
- `type` (enum, optional, default "future") — 'future' (upcoming, default) or 'past' events. [one of: future, past]
- `page` (integer, optional, default 1) — Event page (30/page). Page until meta.has_more is false.

**Returns:** events[]{event_id, name, url, start_date, end_date, timezone, summary, image, is_online, is_free, price_range, currency, status, category, venue{...}} + meta{page, has_more, next_page}

**Example request body:**
```json
{
  "organizer_id": "105655500371"
}
```

### POST /eventbrite/v1/browse — 1 credit
Browse Eventbrite's curated event listings for a city and/or category (the discovery shelf). Returns the featured events for that location/category — same event shape as search. This surface is a single curated page (not paginated); use `search` with a query for paginated results.

**Parameters:**
- `location` (string, optional) — Where to search. Use Eventbrite's location slug '<country>--<city>' (e.g. 'united-states--new-york', 'united-kingdom--london', 'ca--san-francisco'), a US '<state-abbr>--<city>' form, or 'online' for online-only events. Defaults to New York.
- `category` (string, optional) — Category to browse (music, business, food-and-drink, arts, health, sports-and-fitness, community, film-and-media, fashion, hobbies, charity-and-causes, science-and-tech, travel-and-outdoor). Omit for all categories.

**Returns:** events[]{event_id, name, url, start_date, end_date, image, is_online, venue{...}}

**Example request body:**
```json
{
  "location": "united-states--new-york"
}
```

## More
- Try it live, no code: https://reefapi.com/playground?engine=eventbrite
- Human docs page: https://reefapi.com/docs/eventbrite
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt