# Resident Advisor Scraper — Events, Clubs & DJs (`crawloop/resident-advisor-scraper`) Actor

Scrape Resident Advisor events, clubs, and DJ profiles by city, date, or URL. Lineups, venue GPS, attendance, and public booking contacts from public GraphQL. HTTP only, no login.

- **URL**: https://apify.com/crawloop/resident-advisor-scraper.md
- **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community)
- **Categories:** Travel, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 event results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Resident Advisor Scraper — Events, Clubs & DJs

> **Disclaimer:** Unofficial tool — not affiliated with, sponsored by, or endorsed by Resident Advisor Ltd or its affiliates. Data is read from publicly accessible pages only. No login. You are responsible for complying with applicable law (including GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

**Resident Advisor scraper** for Apify — a **RA events scraper** for **city calendars**, **club profiles**, and **DJ pages**. Built for **nightlife aggregation**, **talent booking**, and **venue lead lists**. Export lineups, venue GPS, attendance, ticketed flags, and public booking contacts as JSON. A practical **Resident Advisor API alternative** for Python, Node.js, Sheets, and **MCP** / AI assistants. HTTP-only (no browser).

> **Crawloop Events suite** — ticketed nightlife, editorial club calendars, and general catalogs.

| Resident Advisor Scraper ◄── you are here | [Shotgun Scraper](https://apify.com/crawloop/shotgun-scraper) | [Eventbrite Scraper](https://apify.com/crawloop/eventbrite-scraper) |
| :--- | :--- | :--- |
| Club nights, lineups, RA clubs & DJs | Ticketed club nights, prices, SKUs | Conferences, gigs, organizers |

### When to use this Actor

- **Resident Advisor events scraper** — city name, `uk/london` path, or numeric area id, plus a date window
- **Club / venue scraper** — up to 20 clubs per city (RA list cap), or a `/clubs/{id}` URL (address, phone, capacity, website)
- **DJ / artist scraper** — search a name or paste `/dj/slug` (socials + public booking blurb)
- **Change monitor** — scheduled runs that emit only new or changed rows
- **RA API alternative** — structured GraphQL dataset without a partner key

### When not to use this Actor

- **RA Pro, orders, barcodes, or guest lists** — promoter/account surfaces, not public listings
- **Guaranteed ticket SKU prices** — listings expose `isTicketed` and a cost string when RA publishes one; use [Shotgun Scraper](https://apify.com/crawloop/shotgun-scraper) for nightlife SKUs
- **Magazine, reviews, or RA Exchange** — out of scope for this Actor
- **Private or unlisted events** — public listings only
- **Mainstream ticketed catalogs (conferences, local gigs with SKU prices)** — use [Eventbrite Scraper](https://apify.com/crawloop/eventbrite-scraper)

### Key features

- **HTTP GraphQL** — first-party public `ra.co/graphql`. No headless browser, no API key
- **City resolver** — `London`, `uk/london`, or `13` all work (no hardcoded city map)
- **Start URLs** — event, city calendar, club, and DJ pages auto-routed
- **Rich event rows** — lineup ids, venue GPS/capacity, promoters, genres, attending, RA Pick
- **DJ booking blurb** — public `bookingDetails` when the artist published it
- **Monitor mode** — remember ids between runs; emit only `new` or `changed`
- **Caps that save budget** — `maxItems` (default 50)
- **Proxy optional** — public GraphQL usually works from datacenter HTTP

### Input Parameters

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `mode` | String | `events` | `events`, `venues`, or `artists`. URLs are auto-routed either way |
| `areas` | Array | — | City name, RA path (`de/berlin`), or numeric area id |
| `startUrls` | Array | — | Event, city, club, or DJ URLs |
| `searchTerms` | Array | — | DJ names (artists mode) or club names (venues mode) |
| `dateFrom` / `dateTo` | String | today / +30 days | `YYYY-MM-DD` listing window |
| `genres` | Array | — | Keep events tagged with these RA genre names/slugs |
| `festivalsOnly` | Boolean | `false` | Festival / multi-day events only |
| `venueOrderBy` | String | `POPULAR` | Club list sort: Popular / Latest / Alphabetical (max 20 clubs per city) |
| `maxItems` | Integer | `50` | Hard cap (`0` = unlimited) |
| `monitorMode` | Boolean | `false` | Emit only new & changed rows |
| `monitorKey` | String | `default` | Isolated monitor memory per saved search |
| `requestDelaySecs` | Number | `0.15` | Delay between GraphQL requests |
| `proxyConfiguration` | Object | off | Enable only if you see HTTP 403/429 |

Provide **at least one** of: `areas`, `startUrls`, `searchTerms`.

#### Input example — city calendar

```json
{
  "mode": "events",
  "areas": ["london"],
  "dateFrom": "2026-09-18",
  "dateTo": "2026-09-25",
  "maxItems": 50
}
```

#### Input example — city path + genres

```json
{
  "mode": "events",
  "areas": ["de/berlin", "uk/london"],
  "genres": ["techno"],
  "maxItems": 100
}
```

#### Input example — event URL + club + DJ

```json
{
  "startUrls": [
    { "url": "https://ra.co/events/2516476" },
    { "url": "https://ra.co/clubs/237" },
    { "url": "https://ra.co/dj/frankyrizardo" }
  ]
}
```

#### Input example — monitor a city

```json
{
  "mode": "events",
  "areas": ["berlin"],
  "maxItems": 200,
  "monitorMode": true,
  "monitorKey": "berlin-nights"
}
```

### Output

Each dataset item is one **event**, **venue**, or **artist** (`recordType`).

| Field | Type | Description |
| :--- | :--- | :--- |
| `recordType` | String | `event`, `venue`, or `artist` |
| `id` | String | Stable RA id |
| `title` / `name` | String | Event title or profile name |
| `url` | String | Canonical ra.co page |
| `startTime` / `endTime` | String | Event timestamps |
| `timezone` | String | IANA timezone from the RA area |
| `venueName` / `city` / `country` | String | Where it happens |
| `latitude` / `longitude` | Number | Venue GPS |
| `artists` / `artistNames` | Array | Lineup with ids and `/dj/` URLs |
| `genres` | Array | RA genre id/name/slug |
| `promoters` | Array | Promoter id/name/URL |
| `cost` | String | Cost text when RA publishes one |
| `isTicketed` / `isSoldOut` / `isFestival` | Boolean | Public flags |
| `attending` | Integer | Public attending count |
| `phone` / `website` / `capacity` | String | Club contact fields |
| `bookingDetails` | String | Public DJ booking blurb (often includes an email) |
| `monitorChange` | String | `new` or `changed` in monitor mode |
| `scrapedAt` | String | UTC timestamp |

#### Output example — event

```json
{
  "recordType": "event",
  "id": "2516476",
  "title": "KOKO Electronic: Franky Rizardo [SOLD OUT]",
  "url": "https://ra.co/events/2516476",
  "startTime": "2026-09-18T22:00:00.000",
  "endTime": "2026-09-19T05:00:00.000",
  "timezone": "Europe/London",
  "venueName": "KOKO",
  "city": "London",
  "country": "United Kingdom",
  "latitude": 51.534617,
  "longitude": -0.138338,
  "isTicketed": true,
  "isSoldOut": true,
  "attending": 1295,
  "artistNames": ["Franky Rizardo", "Toman", "Chelina Manuhutu"]
}
```

### Use cases

- **City nightlife calendars** — London / Berlin / NYC week or month dumps for aggregators
- **Talent booking** — DJ profiles with public booking blurbs and socials
- **Venue leads** — club address, phone, capacity, website by city
- **Demand signals** — attending counts and sold-out flags for pricing or editorial
- **Change monitoring** — Scheduler + `monitorMode` for newly announced nights

### Integration examples

#### Node.js

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/resident-advisor-scraper').call({
  mode: 'events',
  areas: ['london'],
  maxItems: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 5));
```

#### Python

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("crawloop/resident-advisor-scraper").call(
    run_input={"mode": "events", "areas": ["london"], "maxItems": 50}
)
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items[:5])
```

#### cURL

```bash
curl "https://api.apify.com/v2/acts/crawloop~resident-advisor-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"events","areas":["london"],"maxItems":50}'
```

### MCP and AI assistants

Use this Actor from AI tools via [Apify MCP](https://docs.apify.com/platform/integrations/mcp).
Connect your Apify account, then call this Actor by its Store ID `crawloop/resident-advisor-scraper`.

Example prompts:

- "Run crawloop/resident-advisor-scraper for London this week and return the top 20 events as JSON"
- "Scrape Resident Advisor techno events in Berlin and summarize venue and lineup fields"
- "Chain Resident Advisor Scraper then Shotgun Scraper for Paris this weekend — editorial lineups plus ticket SKUs"

### FAQ

**Do I need an API key?** No. The Actor uses Resident Advisor’s public website GraphQL.

**How do I find an area id?** You do not have to. Pass `London` or `uk/london`. Numeric ids (London `13`, Berlin `34`) still work.

**Why are ticket prices missing?** Many events only expose `isTicketed` plus a free-text `cost`. This Actor does not invent SKU prices.

**Can I watch a city for new nights?** Yes. Turn on `monitorMode`, set a stable `monitorKey`, and run on Apify Scheduler.

**Does it work without a proxy?** Usually yes. Enable a proxy only after 403/429.

**Can I scrape Resident Advisor with Python or Node.js?** Yes. Call `crawloop/resident-advisor-scraper` from the Apify client (examples above) or via **MCP**. The dataset is JSON.

**Does monitor mode write unchanged events?** No. Unchanged rows are skipped and not added to the dataset.

### What to run next

After a Resident Advisor city dump, run [Shotgun Scraper](https://apify.com/crawloop/shotgun-scraper) for the same city when you need ticket display prices, sold-out flags, and SKUs. Use [Eventbrite Scraper](https://apify.com/crawloop/eventbrite-scraper) for conferences and general catalogs. Keep magazine or editorial scrapes out of the same run.

### Related Actors

- [Shotgun Scraper](https://apify.com/crawloop/shotgun-scraper) — Shotgun.live events, venues, artists, ticket prices
- [Eventbrite Scraper](https://apify.com/crawloop/eventbrite-scraper) — city search, event URLs, organizers, ticket price range

# Actor input Schema

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

What to scrape. Start URLs are auto-routed regardless of mode.

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

City name (London), RA path from the events URL (uk/london, de/berlin), or numeric area id (13).

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

ra.co event (/events/123), city (/events/uk/london), club (/clubs/237), or DJ (/dj/slug) pages. Auto-detected.

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

DJ / artist names in artists mode, or club names in venues mode (e.g. Berghain, Franky Rizardo).

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

Events on or after this date. Default: today.

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

Events on or before this date. Default: today + 30 days.

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

Keep events tagged with at least one of these RA genre names or slugs (techno, house, drum-and-bass). Empty = all.

## `festivalsOnly` (type: `boolean`):

Keep only festival / multi-day events.

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

Venues mode — sort the per-city club list.

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

Hard cap across all inputs. 0 = no cap.

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

Remember ids between runs and emit only NEW or CHANGED rows (dates, attendance, sold-out, booking details).

## `monitorKey` (type: `string`):

Distinct key per saved search so monitors do not share state.

## `requestDelaySecs` (type: `number`):

Throttle between GraphQL requests.

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

Public GraphQL usually works without a proxy. Enable Apify Proxy only if you hit HTTP 403/429.

## Actor input object example

```json
{
  "mode": "events",
  "areas": [
    "london"
  ],
  "startUrls": [],
  "searchTerms": [],
  "dateFrom": "",
  "dateTo": "",
  "genres": [],
  "festivalsOnly": false,
  "venueOrderBy": "POPULAR",
  "maxItems": 50,
  "monitorMode": false,
  "monitorKey": "default",
  "requestDelaySecs": 0.15,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Default dataset items.

# 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"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawloop/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"] }

# Run the Actor and wait for it to finish
run = client.actor("crawloop/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"
  ]
}' |
apify call crawloop/resident-advisor-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawloop/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/NEqXL4gogf5InP8Mj/builds/4ngEfCwrCm3dbgwbd/openapi.json