RA APIra.co ↗
Access Resident Advisor's global electronic music database. Query clubs by city, get venue profiles with capacity and contact info, and browse upcoming event lineups.
What is the RA API?
The RA.co API exposes 7 endpoints covering Resident Advisor's global database of electronic music venues, artists, and events. Use list_clubs to retrieve all venues in a city sorted by follower count, get_club_detail to pull capacity, phone, website, and editorial description for a specific venue, and list_area_events or list_events to page through upcoming event lineups with full artist rosters and flyer URLs.
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
Venue Discovery and Profiles
The list_clubs endpoint accepts an area_name and country_code and returns every RA-listed venue for that city in a single, un-paginated response sorted by follower_count descending. Each club summary includes id, name, address, content_url, logo_url, and an is_closed flag. Feed any returned id into get_club_detail to retrieve deeper profile data: capacity, phone, website, a long-form blurb, and structured area and country objects. Fields are null for venues with incomplete RA profiles rather than omitted, so response shapes are consistent.
Event Listings by Venue or City
list_events returns upcoming events for a single club filtered by club_id, with optional date_from, page, and page_size (max 50) parameters. Each event object carries id, title, date, start_time, flyer_url, interested_count, and an artists array of {id, name} objects. For city-wide coverage, list_area_events accepts a numeric area_id (obtainable from get_club_detail's area.id field or known values like 8 for New York City) and pages through all events across every venue in that area. If you need to resolve a city name to its numeric area_id, call search_areas first with a free-text city string and optional country filter.
Event and Artist Detail
get_event_detail accepts a numeric event_id and returns the complete event record: cost, end_time, sold_out status (boolean or null when ticketing is not tracked), a venue object with address, and the full artists lineup with individual RA profile URLs. When an event does not exist the endpoint returns a stale_input marker rather than a 404, which is worth handling explicitly. get_artist_detail returns a DJ/producer profile including bio, blurb, aliases, pronouns, image_url, social links, and an array of mixes with duration and content_url for each recorded set.
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?+
- Map all open electronic music venues in a city ranked by RA follower count using list_clubs.
- Build a venue directory with capacity, contact details, and website pulled from get_club_detail.
- Aggregate this-weekend's events across a city via list_area_events filtered with date_from.
- Track whether a specific event is sold out by polling the sold_out field in get_event_detail.
- Generate artist profile pages with biography, aliases, and linked mixes from get_artist_detail.
- Notify users about new upcoming events at a favourite club by diffing list_events results over time.
- Resolve a user-supplied city name to a numeric area_id before querying list_area_events using search_areas.
| 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.