# Resident Advisor Events Scraper (`parseforge/residentadvisor-events-scraper`) Actor

Scrapes electronic music events from Resident Advisor by city area ID or keyword query. Returns each event as a flat row with lineup, venue, date, and ticket link.

- **URL**: https://apify.com/parseforge/residentadvisor-events-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Other, News
- **Stats:** 9 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $19.00 / 1,000 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Resident Advisor Events Scraper

**Scrape electronic music events from Resident Advisor by city, artist, or venue, up to a million per run.** Every event comes with its lineup, venue, date, and ticket link. No login or API key. Export to CSV, JSON, Excel, or XML.

Resident Advisor's official API is restricted and requires partnership approval. This Actor reads the public event listings directly, filtered by city ID or keyword search, and returns each match in one fixed schema. It is built for promoters, agents, and researchers who need structured RA data without manual copying.

| Who uses it | What they scrape Resident Advisor for |
|---|---|
| Talent buyers | Discovering which DJs are touring specific cities this month. |
| Event promoters | Monitoring competitor lineups and ticket availability in their region. |
| Music journalists | Tracking genre trends and emerging artists across global club scenes. |
| Artist managers | Finding venues that book similar acts for tour routing. |

### What it does

This Actor collects Resident Advisor events by city area ID or keyword query and returns each one as a flat row.

- 📍 **City area ID:** Target a specific city using its RA area code, like 13 for London or 34 for New York.
- 🔍 **Keyword search:** Filter events by artist name, venue, or event title to narrow the feed.
- 📊 **Structured output:** Every event returns as a flat row with lineup, venue, date, and ticket link, ready for analysis.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Resident Advisor data

**🎧 Build a tour routing list.**

A talent buyer scrapes all events in Berlin this weekend to see which venues have open dates and which DJs are already booked.

**📈 Track genre popularity.**

A music data analyst collects a month of events across five cities and counts genre tags to report on rising sounds.

**📍 Monitor competitor promoters.**

A nightclub owner scrapes events in their city weekly to track rival party series, lineups, and ticket links.

**📰 Feed a local event calendar.**

A city guide website scrapes RA events daily and republishes the lineup, venue, and date on their own listings page.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key needed** | Reads public RA listings without registration or approval. |
| **Fixed schema** | Every event arrives in the same flat structure for easy database import. |
| **Scalable runs** | Collect up to a million events in a single run. |

### How it compares

This Actor focuses on fast, schema-consistent event collection by city and keyword, while other RA scrapers may offer additional promoter enrichment or different filtering approaches.

| Feature | ParseForge | Resident Advisor Events Scraper | Resident Advisor Scraper - Electronic Music Events | Resident Advisor Scraper - Events & Lineups |
|---|---|---|---|---|
| Scrape by city area ID | Yes | Yes | Not listed | Not listed |
| Keyword search by artist or venue | Yes | Not listed | Not listed | Not listed |
| Event lineup data | Yes | Yes | Yes | Yes |
| Promoter social handles and follower count | Not listed | Not listed | Yes | Not listed |
| Ticket link extraction | Yes | Yes | Yes | Not listed |
| Genre tags | Yes | Yes | Not listed | Not listed |

### Configure the run

Drive the Actor from a city area ID and an optional keyword query, and the maxItems limit controls how many events reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "maxItems": 10
}
```

A larger pull:

```json
{
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.021 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Resident Advisor Events Scraper](https://apify.com/parseforge/residentadvisor-events-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Resident Advisor through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/residentadvisor-events-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your area ID is correct. Try a well-known ID like 13 for London. Also, ensure your keyword query is not too restrictive. A typo in an artist name will return zero matches.

**The run is taking a long time.**

Lower the maxItems value. Collecting thousands of events requires fetching many pages, which takes time. Start with a small number to test your input.

**Some events are missing the lineup.**

Not every RA event listing includes a full lineup. The Actor returns whatever is publicly displayed on the event page.

**I get an error about the area ID.**

The area ID must be an integer. Do not include letters or the city name. Use the numeric code from the RA city page URL.

**The output has duplicate events.**

RA listings can sometimes show the same event across multiple queries. Use a deduplication tool or filter by event ID in your post-processing step.

### FAQ

| Question | Answer |
|---|---|
| What is a Resident Advisor area ID? | It is the numeric code RA uses for each city. For example, 13 is London and 34 is New York. You can find other IDs by browsing ra.co and looking at the URL for the city page. |
| Can I scrape multiple cities in one run? | The Actor accepts one area ID per run. To collect events from several cities, run the Actor multiple times with different area IDs, or use a keyword query that spans locations. |
| Does this scraper need a Resident Advisor login? | No. It reads the public event pages that anyone can view without an account. |
| What data fields does each event row include? | Each row includes the event title, date, venue name, lineup artists, ticket link, and genre tags. The exact field list is visible in a sample output on the Actor's page. |
| Can I filter by date range? | The Actor collects events from the default listing order on RA. It does not have a built-in date-range filter, but you can set a maxItems limit and sort the results afterward. |
| How do I search for a specific artist? | Enter the artist name in the keyword query field. The Actor will return events where that name appears in the title or lineup. |
| Is this an official Resident Advisor API? | No, this is an unofficial scraper that reads the public website. It is not affiliated with Resident Advisor Ltd. |
| Can I get the promoter or organizer contact info? | The Actor returns the data visible on the public event page. Promoter contact details are not always present and are not a guaranteed field. |
| What export formats are supported? | You can export your dataset in CSV, JSON, Excel, XML, and several other formats from the Apify platform. |
| How many events can I scrape? | You set the maximum with the maxItems field, up to one million events per run. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Resident Advisor Ltd. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

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

How many events to collect per run.

## `query` (type: `string`):

Keyword search

## `area` (type: `integer`):

ra.co area ID (e.g. 13 = London, 34 = New York)

## Actor input object example

```json
{
  "maxItems": 10,
  "area": 13
}
```

# Actor output Schema

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

No description

# 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 = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/residentadvisor-events-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 = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/residentadvisor-events-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 '{
  "maxItems": 10
}' |
apify call parseforge/residentadvisor-events-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/residentadvisor-events-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/ZyoAmUEHC9zvWeRu2/builds/GYSbUSchGBezNMC18/openapi.json