# Resident Advisor — 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.

> Discover electronic music venues worldwide and explore their upcoming events—search clubs by city, view detailed venue profiles with contact information and activity metrics, and browse event listings for any location. Perfect for finding the best music venues and planning your next night out in the global electronic music scene.

**Category:** Music | **Website:** [ra.co/](https://ra.co/) | **Docs:** [parse.bot/marketplace/b94a9801-8a5c-490a-9b42-7c41751ebf76/ra-co-api](https://parse.bot/marketplace/b94a9801-8a5c-490a-9b42-7c41751ebf76/ra-co-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-ra-co-api-b94a9801/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artist_detail

Get detailed artist/DJ profile information including biography, social media links, mixes, and upcoming events. Returns null for artists with incomplete profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | Artist numeric ID from RA.co (obtainable from event artist lists in list_events or list_area_events results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ra-co-api-b94a9801/get_artist_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>"}'
```

### get_club_detail

Get detailed information about a specific club/venue including contact info, description, capacity, top artists, and event activity metrics. Returns null fields for venues with incomplete profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `club_id` | string | Yes | Club/venue numeric ID from RA.co (obtainable from list_clubs results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ra-co-api-b94a9801/get_club_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"club_id":"<string>"}'
```

### get_event_detail

Get full details for a specific event by its numeric ID. Returns event metadata (title, dates, cost, description), venue with address, artist lineup, flyer image, sold-out status, and editorial pick blurb when available. Returns stale_input when the event ID does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event numeric ID from RA.co (obtainable from list_events or list_area_events results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ra-co-api-b94a9801/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### list_area_events

List upcoming events across all venues in a city/area. Returns events sorted by date ascending then popularity. Supports pagination with configurable page size (max 50). Use area IDs obtainable from get_club_detail results (area.id field) or known IDs like 8 (New York City), 34 (Berlin), 13 (London), 44 (Paris), 22 (Washington DC), 450 (Vienna). Artist lineups include both linked RA profiles (with id and content_url) and unlinked names (with null id/content_url) parsed from the event's full lineup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_id` | string | Yes | Numeric area/city ID from RA.co. Obtainable from get_club_detail response (area.id). Known values: 8 (New York City), 34 (Berlin), 13 (London), 44 (Paris), 22 (Washington DC), 23 (Los Angeles), 17 (Chicago), 38 (Miami), 218 (San Francisco/Oakland), 450 (Vienna). |
| `date_from` | string | No | Filter events from this date in ISO format (e.g. '2026-07-12'). Defaults to current UTC date. |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of events per page (max 50). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ra-co-api-b94a9801/list_area_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_id":"<string>","date_from":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### list_clubs

List all clubs/venues in a given city area on RA.co. Returns venue names, addresses, follower counts, and IDs sorted by follower count (most popular first). The full list for the requested area is returned in a single response (no pagination). Areas and country codes correspond to RA.co URL segments.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_name` | string | No | Area/city URL name (e.g., 'washingtondc', 'paris', 'berlin', 'london', 'vienna'). |
| `country_code` | string | No | Country URL code (e.g., 'us', 'fr', 'uk', 'de', 'at'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ra-co-api-b94a9801/list_clubs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_name":"<string>","country_code":"<string>"}'
```

### list_events

List upcoming events for a specific club/venue. Returns event details including title, date, artists, and venue info. Sorted by date ascending. Supports pagination with configurable page size (max 50). Defaults to events from the current UTC time onward. Artist lineups include both linked RA profiles (with id and content_url) and unlinked names (with null id/content_url) parsed from the event's full lineup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `club_id` | string | Yes | Club/venue numeric ID to list events for (obtainable from list_clubs results). |
| `date_from` | string | No | Filter events from this date in ISO format (e.g. '2026-01-01T00:00:00.000Z'). Defaults to current UTC time. |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of events per page (max 50). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ra-co-api-b94a9801/list_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"club_id":"<string>","date_from":"<string>","page":"<integer>","page_size":"<integer>"}'
```