RA APIra.co ↗
Access Resident Advisor's global database of electronic music venues, upcoming events, and DJ profiles via 6 structured endpoints.
What is the RA API?
The RA.co API provides access to Resident Advisor's global database of electronic music clubs, events, and artist profiles across 6 endpoints. Starting with list_clubs, you can retrieve every venue in a given city sorted by follower count, then drill into individual venue profiles, artist biographies, and paginated event listings — all returning structured JSON with consistent ID fields that chain between endpoints.
curl -X GET 'https://api.parse.bot/scraper/b89b7fc2-7fcb-49f4-8b0d-8ba592c967cc/list_clubs?area_name=berlin&country_code=de' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| area_name | string | Area/city URL name (e.g., 'washingtondc', 'paris', 'berlin', 'london', 'vienna'). |
| country_code | string | Country URL code (e.g., 'us', 'fr', 'uk', 'de', 'at'). |
{
"type": "object",
"fields": {
"area": "string — area name as passed in the request",
"clubs": "array of club summary objects with keys: id, name, address, content_url, follower_count, is_closed, logo_url",
"country": "string — country code as passed in the request",
"total_clubs": "integer — total number of clubs returned"
},
"sample": {
"data": {
"area": "berlin",
"clubs": [
{
"id": "5031",
"name": "Berghain | Panorama Bar | Säule",
"address": "70 Am Wriezener Bahnhof; Friedrichshain; 10243 Berlin; Germany",
"logo_url": "https://static.ra.co/images/clubs/berghain-berlin-logo.jpg?dateUpdated=1610108248310",
"is_closed": null,
"content_url": "/clubs/5031",
"follower_count": 45211
}
],
"country": "de",
"total_clubs": 2275
},
"status": "success"
}
}About the RA API
Venues and Club Data
The list_clubs endpoint accepts an area_name (e.g., berlin, london, washingtondc) and a country_code and returns the full venue list for that area in one response — no pagination required. Each entry includes the venue id, name, address, follower_count, is_closed flag, and logo_url. The get_club_detail endpoint takes one of those club_id values and returns richer fields: capacity, phone, website, blurb, and nested area and country objects. Fields are null for venues with incomplete RA profiles.
Events by Venue or City
list_events returns upcoming events for a specific venue, filtered by club_id and an optional date_from in ISO format. Each event object carries id, title, date, start_time, interested_count, flyer_url, and an artists array — making it straightforward to build a lineup view. list_area_events works the same way but takes an area_id (e.g., 8 for New York City, 34 for London) and returns events across all venues in that city. Both endpoints support pagination via page and page_size (max 50 per page), and return total_results so you can calculate page counts.
Events and Artist Profiles
get_event_detail accepts an event_id from any event list and returns the full record: cost, end_time, artists lineup with profile links, and flyer_url. If the event ID does not exist, the response signals stale_input rather than a generic error. get_artist_detail takes an artist_id surfaced in event artist arrays and returns the DJ's bio, blurb, aliases, pronouns, image_url, country, and a mixes array with mix duration and date — covering the artist metadata RA publishes on public profiles.
The RA API is a managed, monitored endpoint for ra.co — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ra.co changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ra.co API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a city-level event calendar by combining
list_area_eventswith known area IDs for major markets. - Track venue popularity trends by storing
follower_countvalues from periodiclist_clubscalls. - Generate artist lineup pages for festivals by resolving each
artist_idviaget_artist_detail. - Monitor newly announced club nights by polling
list_eventsfor a set of venue IDs and comparingtotal_results. - Populate a venue directory with contact details, capacity, and website from
get_club_detail. - Flag permanently closed venues using the
is_closedfield returned bylist_clubs. - Surface artist mixes and podcast credits by reading the
mixesarray fromget_artist_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Resident Advisor have an official developer API?+
How do I find the area_id needed for list_area_events?+
get_club_detail for any venue in the city you want; the response includes an area object with an id field. Some common IDs are also documented in the endpoint description: 8 for New York City, 34 for London.Does list_clubs cover all cities worldwide, or only major markets?+
total_clubs field in the response tells you exactly how many venues are indexed for the requested area.Does the API return historical past events or ticket purchase links?+
list_events, list_area_events) default to upcoming events from the current date onward, and event objects include cost text but no direct ticketing URLs. You can fork this API on Parse and revise it to add an endpoint targeting past event data or ticket provider links.What does get_event_detail return when an event ID no longer exists?+
stale_input signal rather than a generic 404 or empty response. This lets callers distinguish between a valid ID for a deleted event and a malformed request.