# Allevents — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover events from AllEvents.in by name, date, or category, then view detailed information like descriptions, timings, and venue details. Filter through available event categories to find exactly what you're looking for.

**Category:** Entertainment | **Website:** [allevents.in/](https://allevents.in/) | **Docs:** [parse.bot/marketplace/d0927f9c-3ea1-448e-8105-4e172bd02a04/allevents-in-api](https://parse.bot/marketplace/d0927f9c-3ea1-448e-8105-4e172bd02a04/allevents-in-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-allevents-in-api-d0927f9c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Get available event categories for a specific city. Returns category slugs, display names, and event counts. Use the slug values as the category parameter in search_events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name to get available categories for (e.g. "London", "New York", "Tokyo"). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allevents-in-api-d0927f9c/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_event_details

Get detailed information for a specific event including full description and ticket purchase link. Extracts data from the event page's structured JSON-LD and HTML content. Fields returned vary by event source — some fields may be absent when the event page lacks structured data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_url` | string | Yes | Full URL of the event page (e.g. "https://allevents.in/london/<event-slug>/<event-id>"). Obtain from event_url field in search_events or search_events_by_date results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allevents-in-api-d0927f9c/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_url":"<string>"}'
```

### search_events

Search for events in a city by category. Returns a paginated list of events with basic info including name, dates, venue, and ticket availability. Paginates by adjusting limit. Each event includes a nested venue object with geographic coordinates and a tickets object indicating availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Event category slug to filter by. Use get_categories endpoint to discover available slugs for a city. Common values include "entertainment", "music", "art", "parties". |
| `city` | string | Yes | City name to search events in (e.g. "London", "New York", "Tokyo"). |
| `limit` | integer | No | Maximum number of events to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allevents-in-api-d0927f9c/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","city":"<string>","limit":"<integer>"}'
```

### search_events_by_date

Search for events in a city filtered by date range. Returns events occurring within the specified start and end dates. Each event has the same shape as search_events results. Useful for finding events on specific days or within a time window.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name to search events in (e.g. "London", "New York"). |
| `end_date` | string | No | End date in "YYYY-MM-DD HH:MM" format (e.g. "2026-06-30 23:59"). |
| `limit` | integer | No | Maximum number of events to return. |
| `start_date` | string | No | Start date in "YYYY-MM-DD HH:MM" format (e.g. "2026-06-15 00:00"). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allevents-in-api-d0927f9c/search_events_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","end_date":"<string>","limit":"<integer>","start_date":"<string>"}'
```