# Resident Advisor Scraper - Events, Lineups, Tickets & Clubs (`topapi/resident-advisor-scraper`) Actor

Scrape Resident Advisor (ra.co) events by city, country, radius, club, promoter, artist or link: full lineups, set times, RA ticket tiers and prices, venue address and GPS, promoters, genres, attending. Clubs, promoters and DJs with booking e-mails too. Monitor mode. $1.30 per 1,000 events.

- **URL**: https://apify.com/topapi/resident-advisor-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Lead generation, Social media, Automation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.30 / 1,000 events

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Resident Advisor Scraper do?

**Resident Advisor Scraper** reads Resident Advisor (ra.co), the electronic-music listings site, and turns a city, a country, a radius, a club, a promoter, an artist or a link into rows: one row per event with its venue (address, phone, coordinates), the full lineup, set times, promoters, genres, RA ticket tiers with prices and sale status, attending count, RA Pick and description. It also returns clubs, promoters and artists (with booking e-mails) as rows of their own. Built for event apps and city guides, booking agents, promoters, ticketing and nightlife suppliers, and music-market researchers.

Resident Advisor API - RA.co Scraper - RA Events Scraper - Resident Advisor Events Scraper

- **Every RA event, any place:** a city, an RA area, a whole country, a radius in km around a city or point, or the whole world - upcoming or RA's archive back to the early 2000s.
- **The full event in one row:** venue with address and GPS, linked and unlinked lineup acts, set times, promoters, genres, every RA ticket tier, attending, RA Pick text, flyer, description, local and UTC times.
- **Clubs, promoters and artists too:** a city's whole club or promoter directory, most followed first, or any club / promoter / artist by name or link - artist rows carry the booking details and booking e-mails from their RA profile.
- **Newly announced events:** "Announced since" asks RA for events published since a date, and monitor mode returns only events not delivered before (or also the ones whose lineup, time or tickets changed).
- **No login, cookies or RA API key:** it reads the same data endpoint RA's own website uses.
- **Pay only for delivered rows:** $1.30 per 1,000 events, no start fee; duplicates, filtered and already-delivered events are never charged.
- **Export anywhere, works with AI agents:** JSON, CSV, Excel; schedules, webhooks, Make, Zapier, n8n, Google Sheets; the Apify API and MCP server.

### What data can you get from Resident Advisor?

<table>
<tr><td>🎫 Event title, link, RA id</td><td>📅 Date, start, end (local + UTC), time zone</td><td>📍 Venue, address, latitude / longitude</td></tr>
<tr><td>🎧 Lineup: linked artists, unlinked acts, all acts in order</td><td>⏱️ Set times when published</td><td>🏷️ Genres</td></tr>
<tr><td>💷 RA ticket tiers: price, currency, on sale / sold out, sale dates</td><td>💲 Price min / max / currency, free or paid</td><td>👥 Attending / interested</td></tr>
<tr><td>📣 Promoters (+ website and socials on request)</td><td>⭐ RA Pick and the editor's text</td><td>🖼️ Flyer images</td></tr>
<tr><td>🏢 Clubs: address, phone, website, capacity, followers, events this year</td><td>🎛️ Promoters: website, Instagram, Facebook, X, YouTube, followers</td><td>🎤 Artists: booking details and e-mails, socials, followers, related artists, labels</td></tr>
</table>

Measured on a 1,000-event run in Berlin (2026-11-07): coordinates 100%, venue address 94%, genres 80%, at least one lineup act 88% (69% with an RA artist profile), RA ticket tiers 47% (the rest sell elsewhere), a price 71%, description 91%, flyer 94%, promoters 82%, venue phone 36%.

### How to scrape Resident Advisor with Resident Advisor Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) - $5 of monthly credit, no card needed.
2. Open [Resident Advisor Scraper](https://apify.com/topapi/resident-advisor-scraper) and click **Try for free**.
3. Type a city into **Cities / RA areas** (`London`, `Berlin`, `New York City`), or paste RA links, and set **Max rows**.
4. Click **Start**. Rows stream into the dataset: 1,000 London events took about 7 seconds.
5. Open the **Storage** tab and **Export** as JSON, CSV or Excel - or let a schedule run it for you.

### ⬇️ Input

| Section | Field | What it does | Default |
|---|---|---|---|
| What to scrape | `mode` | `events`, `venues` (clubs), `promoters` or `artists` | `events` |
| | `areas` | City names, RA area paths (`de/berlin`), RA city links, area ids (`34`), a country name, `"lat,lng"`, or `Worldwide` | - (London when nothing is given) |
| | `startUrls` | Any ra.co link: events, event id ranges (`/events/2532580-2532600`), cities, clubs, promoters, artists, club / promoter directories | - |
| | `searchTerms` | Events: words in the title (RA's own title search). Profiles: names to look up | - |
| More places | `countries`, `worldwide`, `radiusKm` | Every area of a country; every RA event; a circle around each city or point | - |
| | `venues`, `promoters`, `artists` | Names, RA links or ids: their events (events mode) or their profiles (profile modes) | - |
| | `eventIds` | RA event ids, read as they are | - |
| When | `dateFrom`, `dateTo` | `2026-12-01`, `today`, `+7`, `+30`, `+3 months`, or past dates for the archive | today, no end |
| | `postedSince` | Only events RA published since: `-1 day`, `24h`, `2026-11-01` | - |
| Filters | `genres` | RA genres (names or slugs), any of them | - |
| | `festivals`, `picksOnly` | Festivals any / only / exclude; RA Picks only | any |
| | `ticketedOnly`, `onSaleOnly`, `minAttending` | RA tickets; a tier on sale now; at least N going | - |
| | `price`, `minPrice`, `maxPrice` | Free / paid; price bounds in the event's currency | any |
| Each row | `sortBy` | `date` (RA's order), `popular`, `newest` announced, `dateDesc` | `date` |
| | `includeDescription`, `includeTicketTiers` | Event text; RA ticket tiers | on |
| | `includePromoterDetails`, `includeArtistDetails` | Promoter websites and socials / artist followers, socials and booking e-mails inside each event row | off |
| | `includePast`, `eventsPerProfile` | Past events of clubs, promoters, artists; how many events each profile row lists | off, 10 |
| | `excludeEmptyFields` | Leave out fields RA has no value for | off |
| Lead add-ons | `enrichArtists`, `maxEnrichedArtists` | One artist row per lineup artist of the delivered events | off |
| | `enrichContacts` | E-mails, phones and socials from the website on each club / promoter / artist profile (paid add-on) | off |
| | `relatedArtistsDepth` | Artists mode: also RA's related artists, N steps out | 0 |
| | `venueOrderBy`, `includeClosed` | Directory order: most followed, A to Z, newest on RA; closed clubs too | most followed |
| Limits | `maxItems`, `maxItemsPerArea` | Rows for the run (0 = no limit); rows per city / keyword / club / artist | 50 |
| Monitor | `monitorMode`, `monitorChanges`, `monitorStoreName`, `resetMonitor`, `firstRunMode` | Only new rows each run; also changed events; one memory per name; forget; remember-only first run | off |
| Advanced | `maxConcurrency`, `proxyConfiguration` | Parallel requests; your own proxy first (not needed) | 4, none |

Input names used by other Resident Advisor actors are accepted too (`cities`, `areaIds`, `areaUrls`, `cityNames`, `eventUrls`, `searchUrls`, `startDate`, `endDate`, `dateRangeFrom`, `dateRangeTo`, `daysAhead`, `maxResults`, `maxEvents`, `count`, `festivalsOnly`, `crawlWebsiteContacts`, `newOnly`, `watchName`, `onlyNewOrChanged`, `maxDepth`...).

#### Input JSON

```json
{
  "areas": ["Berlin", "Amsterdam"],
  "dateFrom": "today",
  "dateTo": "+30",
  "genres": ["techno", "house"],
  "maxItemsPerArea": 200,
  "maxItems": 400
}
```

#### A club's, promoter's or artist's events

```json
{
  "venues": ["fabric", "https://ra.co/clubs/5031"],
  "artists": ["Dixon"],
  "includePast": true,
  "dateFrom": "2025-01-01",
  "maxItems": 500
}
```

#### Clubs or promoters of a city, with website contacts

```json
{
  "mode": "venues",
  "areas": ["London"],
  "enrichContacts": true,
  "maxItems": 100
}
```

#### Artists playing a city in the next two weeks

```json
{
  "mode": "artists",
  "areas": ["Berlin"],
  "dateTo": "+14",
  "maxItems": 50
}
```

Each artist row then also carries `eventsFound`, `venuesFound`, `citiesFound`, `totalAttending`, `genres` and the next event in that window.

### ⬆️ Output

One item per event (`type: "event"`), or per club (`"venue"`), promoter (`"promoter"`) or artist (`"artist"`). A real event row from a run on 2026-11-07 (shortened here: one of its ticket tiers shown, the other fields listed below):

```json
{
  "type": "event",
  "id": "2423757",
  "title": "Function 30 × 10 Years of LSD",
  "url": "https://ra.co/events/2423757",
  "date": "2026-11-07T00:00:00.000",
  "startTime": "2026-11-07T23:59:00.000",
  "endTime": "2026-11-08T06:00:00.000",
  "startTimeUtc": "2026-11-07T23:59:00.000Z",
  "timeZone": "Europe/London",
  "durationMinutes": 361,
  "isTicketed": true,
  "minimumAge": 18,
  "cost": "10/25",
  "priceMin": 17.3,
  "priceMax": 69.1,
  "priceCurrency": "GBP",
  "tickets": [
    { "id": "1474042", "title": "3rd release (£20+BF)", "priceRetail": 23, "currency": "GBP", "validType": "VALID", "onSaleFrom": "2026-11-05T14:30:00.000Z", "onSaleUntil": "2026-11-08T06:00:00.000Z", "isAddOn": false }
  ],
  "ticketStatus": "onSale",
  "soldOut": false,
  "attending": 1616,
  "genreNames": ["Techno"],
  "lineupText": "LSD (Luke Slater, Steve Bicknell, Function)\nLivid (UK)",
  "artistNames": ["LSD", "Luke Slater", "Steve Bicknell", "Function", "Livid (UK)"],
  "unlinkedArtists": [],
  "promoterNames": ["E1", "LATENITE COLLECTIVE"],
  "venueName": "E1",
  "venueAddress": "110 Pennington Street, Wapping, London E1W 2BB",
  "latitude": 51.509058,
  "longitude": -0.061664,
  "areaName": "London",
  "countryCode": "GB",
  "isRaPick": false,
  "imageUrl": "https://images.ra.co/396c733f641aa43b9c30dde2cd93f7119d89f847.jpg",
  "datePosted": "2026-04-21T16:00:04.297Z",
  "scrapedAt": "2026-11-07T00:09:42.091Z"
}
```

Every event row also has `eventId`, `contentUrl`, `endTimeUtc`, `listingDate`, `isFestival`, `isMultiDayEvent`, `hasSecretVenue`, `live`, `resaleActive`, `ticketingSystem`, `embargoDate`, `isFree`, `ticketPriceMin`, `ticketPriceMax`, `ticketCurrency`, `onSale`, `ticketUrl`, `interestedCount`, `genres`, `lineup` (RA's text with artist tags), `artists`, `artistIds`, `allArtists`, `setTimes`, `promoters`, `promoterIds`, `venue`, `venueId`, `venueUrl`, `venueCapacity`, `venuePhone`, `venueWebsite`, `venueLive`, `area`, `areaId`, `country`, `countryIsoCode`, `pick`, `raPickBlurb`, `images`, `promotionalLinks`, `playerLinks`, `childEvents`, `content`, `admin`, `dateUpdated` and `searchArea`. Nested objects keep RA's own field names.

A real artist row (Dixon, shortened):

```json
{
  "type": "artist",
  "artistId": "758",
  "name": "Dixon",
  "url": "https://ra.co/dj/dixon",
  "firstName": "Steffen",
  "lastName": "Berkhahn",
  "country": "Germany",
  "homeArea": "Berlin",
  "bookingDetails": "TEMPORARY SECRETARY BOOKING\n\nWorld\nbooking@temporary-secretary.net\n\nNorth America\nandrew@liaisonartists.com...",
  "bookingEmails": ["booking@temporary-secretary.net", "andrew@liaisonartists.com"],
  "website": "http://togetherwedancealone.com",
  "instagram": "https://www.instagram.com/dixon_",
  "soundcloud": "https://www.soundcloud.com/dixon",
  "followerCount": 38861,
  "upcomingEventsCount": 5
}
```

Artist rows also carry `aliases`, `pronouns`, `residentCountry`, `facebook`, `twitter`, `discogs`, `bandcamp`, `image`, `blurb`, `biography`, `relatedArtists`, `artistAreas` (regions played most), `artistVenues` (clubs played most), `artistLabels`, `firstEvent`, `events` and the next event. Club rows: `name`, `address`, `phone`, `website`, `capacity`, `followerCount`, `eventCountThisYear`, `isClosed`, `description`, `photo`, `topArtists`, `upcomingEvents` and the next event. Promoter rows: `website`, `facebook`, `instagram`, `twitter`, `youtube`, `soundcloud`, `socialMediaLinks`, `followerCount`, `upcomingEventsCount`, `upcomingEvents`, `description`, `logoUrl`.

Measured fill: 190 lineup artists in London - booking details 70%, a booking e-mail 67%, SoundCloud 76%, Instagram 65%; London's 50 most followed clubs - website 82%, phone 30%; London's 50 most followed promoters - website 84%, Instagram 74%, Facebook 66%. With **Website contacts** on, an e-mail was found on the club's own website for 20-21 of those 50 clubs and on 9-11 of the 50 promoters' websites.

### How can I use Resident Advisor data?

- **Event apps, newsletters and city guides:** a daily feed of a city's events with lineups, flyers, prices and links.
- **Booking and A\&R:** where an artist plays, who books them (booking e-mails), which clubs and regions they play most.
- **Promoter and venue sales:** club and promoter lists per city with websites, socials, capacity and how busy they are.
- **Ticketing and pricing research:** RA ticket tiers, sold-out status and attendance by city, genre and date.
- **Tour routing and market research:** RA's archive by city and year, genres and attendance over time.

### How much does it cost to scrape Resident Advisor?

Pay per row, no start fee, platform usage included:

| Row | Price |
|---|---|
| Event | $0.0013 ($1.30 per 1,000) |
| Club (venue) | $0.0022 |
| Artist | $0.0022 |
| Promoter | $0.0045 |
| Website contacts (add-on, only for a profile row where an e-mail or phone was found) | $0.009 |

So 50 London events cost $0.065, 1,000 cost $1.30, and London's 50 most followed clubs with website contacts found for 21 of them cost $0.11 + $0.19. Ticket tiers, set times, descriptions, and promoter and artist details inside event rows cost nothing extra. Set a **maximum cost per run** and the run stops cleanly at it.

### Run it on a schedule (only new events)

1. Fill in the places and turn on **Monitor mode** with a **Monitor name**, e.g. `berlin-techno`.
2. Save it as a task and add a schedule (e.g. every morning).
3. The first run returns what the input finds; each later run asks RA only for events published since the last run (minus 48 hours) and delivers the ones not delivered before. A poll with nothing new delivers nothing (measured: $0.00008 of platform usage in under 2 seconds).
4. Turn on **Also changed events** to get events whose title, date / time, venue, lineup, tickets or cost changed, with `changeType: "updated"` and `changedFields`.
5. Turn on promoter details, artist details or website contacts later and the rows delivered before without them come once more with those fields, `changeType: "details"` (charged like any row with them).

```json
{
  "areas": ["Berlin"],
  "genres": ["techno"],
  "monitorMode": true,
  "monitorStoreName": "berlin-techno",
  "maxItems": 0
}
```

Without memory, **Announced since** (`"postedSince": "-1 day"`) gives the same "what was announced since yesterday" list in one run.

Through the API: `POST https://api.apify.com/v2/acts/topapi~resident-advisor-scraper/runs?token=<YOUR_TOKEN>` with the input above as the body.

### Integrations, API, scheduling & MCP

- **Schedules:** hourly, daily or weekly from the **Schedules** tab; with `monitorMode` each run returns only new events.
- **Webhooks:** fire a URL when a run finishes - push rows to your app, CRM, Slack or a sheet.
- **No-code:** Make, Zapier, n8n, Google Sheets, Airtable, Slack via [Apify integrations](https://docs.apify.com/integrations).
- **API:** call it from Node.js or Python with `apify-client` - code on the [API tab](https://apify.com/topapi/resident-advisor-scraper/api/python) and the [Apify API reference](https://docs.apify.com/api/v2).
- **MCP / AI agents:** connect Claude, Cursor or any MCP client through the [MCP tab](https://apify.com/topapi/resident-advisor-scraper/api/mcp) and ask for "techno events in Berlin next weekend".

### More event scrapers

<table>
<tr>
<td>📅 <a href="https://apify.com/topapi/luma-events-scraper">Luma Events Scraper</a></td>
<td>📘 <a href="https://apify.com/topapi/facebook-events-scraper">Facebook Events Scraper</a></td>
<td>🎟️ <a href="https://apify.com/scrapersdelight/eventbrite-scraper">Eventbrite Scraper</a></td>
</tr>
<tr>
<td>🎶 <a href="https://apify.com/scrapersdelight/dice-scraper">DICE Scraper</a></td>
<td>🎧 <a href="https://apify.com/scrapersdelight/soundcloud-scraper">SoundCloud Scraper</a></td>
<td>🧭 <a href="https://apify.com/topapi">All TopApi actors</a></td>
</tr>
</table>

### Limits & empty runs

- **10,000 rows per RA search:** RA pages one search to 10,000 events; a bigger run (a country, worldwide) is split into date windows on its own. 12,000 worldwide events took 6 minutes at the default memory.
- **Clubs and promoters of a city:** RA's directory lists every club or promoter it has for the area, including dormant ones; "most followed first" reads the follower counts too (London's 15,564 promoters: 17-50 seconds). RA has no directory of artists by city - artists mode with a city reads the lineups of that city's events.
- **What RA does not publish to visitors:** promoter e-mail addresses (empty on RA's profiles - use Website contacts), ticket sales numbers, and RA's legacy flyer fields (the flyers are in `images`). A club capacity RA stores as "0" is returned as null.
- **Unlinked lineup acts** are read from RA's lineup text: lines that look like a stage, a time or "TBA" are left out, so an unusual lineup layout can miss or keep a line.
- **Minimum attending** reads RA most attended first and stops at the first event under your number, so those rows come most attended first.
- **Filters RA can't apply** (tickets on sale, price) are checked on each page; a search stops reading once your filters keep too few rows for the pages read, and the status says so.
- **Empty dataset:** a place RA does not know, a keyword with no match, or filters that removed everything - the status message says which. Nothing is charged.

### FAQ

#### How many events can Resident Advisor Scraper collect in one run?

As many as match: set `maxItems: 0` for everything. One RA search pages to 10,000 events and bigger runs are split by date; a 12,000-event worldwide run finished in about 6 minutes, 1,000 London events in about 7 seconds.

#### How much does Resident Advisor Scraper cost?

$1.30 per 1,000 events, $0.0022 per club or artist row, $0.0045 per promoter row, no start fee. Website contacts are $0.009 for a profile row only when an e-mail or phone was found.

#### Can I get past events?

Yes. Set `dateFrom` in the past for a city (RA's archive goes back to the early 2000s), or `includePast` for clubs, promoters and artists.

#### Can I search a radius instead of an RA area?

Yes: `radiusKm` around each city, or give `"lat,lng"` as a place - 50 km around Manchester also found Liverpool events (32 Manchester, 7 Liverpool of 40 in a test run).

#### Does it return artists' booking e-mails?

Artist rows carry the booking section of the RA profile and every e-mail in it (`bookingEmails`), when the artist published one - 67% of 190 London lineup artists had one.

#### Can I run it on a schedule to get only new events?

Yes: `monitorMode` with a schedule; each run returns only events not delivered before, and `monitorChanges` adds events whose lineup, time, venue or tickets changed.

#### Do I need an RA account, cookies or an API key?

No. It reads the data endpoint RA's own website uses, signed out.

#### Can I use it with the Apify API or MCP?

Yes - start runs with the Apify API or `apify-client`, or connect an AI agent through the Apify MCP server.

#### Why did my run return no results?

The place, club or artist name was not found on RA, the date window had no events, or your filters removed every event. The status message says which; nothing is charged.

#### Your feedback

Found a bug or need a field? Open an issue on the **Issues** tab.

# Actor input Schema

## `mode` (type: `string`):

Events: RA event listings. Clubs: RA's club directory for a city, or clubs by name / link. Promoters: same for promoters. Artists: by name / link, or the artists playing a city in your date window.

## `areas` (type: `array`):

City names ("Berlin", "New York City", "Ibiza"), RA area paths ("de/berlin", "us/newyorkcity"), RA city links, RA area ids (34), a country name ("Germany" = all its areas), "lat,lng" points, or "Worldwide".

## `startUrls` (type: `array`):

Any ra.co link: events (/events/2532588), event id ranges (/events/2532580-2532600), city pages (/events/uk/london), clubs (/clubs/237), promoters (/promoters/967), artists (/dj/dixon), club or promoter directories (/clubs/uk/london).

## `searchTerms` (type: `array`):

Events: words in the event title (RA's own title search), e.g. "disco", "boiler room". Clubs / promoters / artists: names to look up ("fabric", "Dixon"), or with a city, words the club or promoter name must contain.

## `countries` (type: `array`):

Every RA area of these countries: "Germany", "uk", "US", "Netherlands" (RA has 202 countries).

## `worldwide` (type: `boolean`):

Every RA event in the date window, all countries (splits past RA's 10,000 rows per search).

## `radiusKm` (type: `integer`):

Search a circle of this many km around each city (or "lat,lng" point) instead of its RA area - e.g. 50 km around Manchester also finds Liverpool events. Clubs mode: clubs within the radius.

## `venues` (type: `array`):

Club names, RA links or ids ("fabric", "https://ra.co/clubs/5031", 237). Events mode: their upcoming (and with Past events, past) events. Clubs mode: their profiles.

## `promoters` (type: `array`):

Promoter names, RA links or ids ("Printworks", "https://ra.co/promoters/967"). Events mode: their events. Promoters mode: their profiles.

## `artists` (type: `array`):

Artist names, RA slugs or links ("Dixon", "boysnoize", "https://ra.co/dj/dixon"). Events mode: their gigs. Artists mode: their profiles with booking contacts.

## `eventIds` (type: `array`):

RA event ids ("2532588"). Read as they are: date and listing filters do not apply to ids and event links.

## `dateFrom` (type: `string`):

Events on or after this day: 2026-12-01, "today" (the default), "+7" (in 7 days) or a past date for RA's archive (events back to the early 2000s).

## `dateTo` (type: `string`):

Events on or before this day: 2026-12-31, "+7", "+30", "+3 months". Empty = no end.

## `postedSince` (type: `string`):

Only events RA published on or after this time: "-1 day", "24h", "-7", 2026-11-01. Newly announced events without monitor memory - RA applies it in its own query.

## `genres` (type: `array`):

RA genres, any of them (RA's own filter): "techno", "house", "Drum & Bass", "afrohouse", "disco", "amapiano"... (70 genres; names or slugs).

## `festivals` (type: `string`):

Keep or drop festivals (RA's own filter).

## `picksOnly` (type: `boolean`):

Only events RA's editors picked (with the pick text).

## `ticketedOnly` (type: `boolean`):

Only events that sell tickets on RA.

## `onSaleOnly` (type: `boolean`):

Only events with at least one RA ticket tier on sale now (not sold out, not ended).

## `minAttending` (type: `integer`):

Only events with at least this many people marked as going on RA.

## `price` (type: `string`):

Free or paid events (from RA's ticket tiers, else the cost text).

## `minPrice` (type: `number`):

Events whose highest price is at least this (event currency).

## `maxPrice` (type: `number`):

Events whose lowest price is at most this (event currency), e.g. 15.

## `sortBy` (type: `string`):

Order of the event rows (RA sorts; a search split into date windows keeps date order).

## `includeDescription` (type: `boolean`):

The event text (`content`). Turn off for lighter rows.

## `includeTicketTiers` (type: `boolean`):

Every RA ticket tier: name, price, currency, on sale / sold out, sale dates.

## `includePromoterDetails` (type: `boolean`):

Each promoter's website, e-mail, socials, followers and upcoming-event count inside the event row (no extra charge).

## `includeArtistDetails` (type: `boolean`):

Each lineup artist's followers, country, website, socials and booking e-mails inside the event row (no extra charge).

## `includePast` (type: `boolean`):

Clubs, promoters and artists: their past events too (most recent first). Profile rows: a past-events list.

## `eventsPerProfile` (type: `integer`):

Clubs, promoters and artists: how many upcoming events each profile row lists (0 = none).

## `excludeEmptyFields` (type: `boolean`):

Drop fields RA has no value for (null, empty text or list) from each row.

## `enrichArtists` (type: `boolean`):

Events mode: also one artist row (charged as an artist) per distinct lineup artist of the delivered events - booking details and e-mails, website, socials, followers.

## `maxEnrichedArtists` (type: `integer`):

Cap on the artist rows of the option above (empty = every lineup artist).

## `enrichContacts` (type: `boolean`):

Club, promoter and artist rows: read the website on the RA profile (home + contact / about pages) for e-mails, phones and socials. Charged per row where one is found.

## `relatedArtistsDepth` (type: `integer`):

Artists mode: also the artists RA lists as related, this many steps out (1 = their related artists).

## `venueOrderBy` (type: `string`):

Order of a city's clubs or promoters (RA's whole directory for the city).

## `includeClosed` (type: `boolean`):

Clubs mode: also clubs RA marks as closed.

## `maxItems` (type: `integer`):

Most rows (events, clubs, promoters or artists) for the run. 0 = no limit.

## `maxItemsPerArea` (type: `integer`):

Most rows per city / keyword / club / promoter / artist. Empty = no per-search limit.

## `monitorMode` (type: `boolean`):

Each run returns only events (or clubs, promoters, artists) not delivered by earlier runs with the same input. Events polls ask RA only for events published since the last run.

## `monitorChanges` (type: `boolean`):

Monitor: also deliver remembered events whose title, date / time, venue, lineup, tickets or cost changed (`changeType: updated`, `changedFields`). Reads the whole scope each poll.

## `monitorStoreName` (type: `string`):

A name per watch, so two schedules don't share memory.

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered (this run delivers everything again).

## `firstRunMode` (type: `string`):

What the first monitor run does.

## `maxConcurrency` (type: `integer`):

Requests to RA at the same time.

## `proxyConfiguration` (type: `object`):

Not needed: RA's data endpoint answers directly. If RA ever refuses, the run moves to the Apify datacenter proxy, then residential, on its own. Set your own proxy here to use it first.

## Actor input object example

```json
{
  "mode": "events",
  "areas": [
    "London"
  ],
  "worldwide": false,
  "festivals": "any",
  "picksOnly": false,
  "ticketedOnly": false,
  "onSaleOnly": false,
  "price": "any",
  "sortBy": "date",
  "includeDescription": true,
  "includeTicketTiers": true,
  "includePromoterDetails": false,
  "includeArtistDetails": false,
  "includePast": false,
  "eventsPerProfile": 10,
  "excludeEmptyFields": false,
  "enrichArtists": false,
  "enrichContacts": false,
  "relatedArtistsDepth": 0,
  "venueOrderBy": "POPULAR",
  "includeClosed": false,
  "maxItems": 20,
  "monitorMode": false,
  "monitorChanges": false,
  "monitorStoreName": "resident-advisor-monitor",
  "resetMonitor": false,
  "firstRunMode": "emitAll",
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per event (or per club, promoter or artist in those modes): date and times, venue with address and coordinates, lineup, promoters, genres, RA ticket tiers, attending, description.

## `summary` (type: `string`):

Per-search counts (matches, read, delivered), look-ups, filters, egress and requests (written for Console runs, large runs and runs with a problem).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "areas": [
        "London"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/resident-advisor-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "areas": ["London"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/resident-advisor-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "areas": [
    "London"
  ],
  "maxItems": 20
}' |
apify call topapi/resident-advisor-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/resident-advisor-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CCJNwjilpeQAy6L5k/builds/Ip6AGa7ojfnXEzAuD/openapi.json
