{ "openapi": "3.0.1", "info": { "title": "Resident Advisor Scraper", "description": "Scrape Resident Advisor (ra.co) events in any city, country or worldwide, past or upcoming: lineup, artists, venue, GPS, tickets, prices, attendance, promoters, socials. Or get artists with booking emails, venues and promoters. Filter by genre, date, price, keyword.", "version": "1.0", "x-build-id": "5WrtMiVhTbUFr3Rbj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~resident-advisor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-resident-advisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/normdata~resident-advisor-scraper/runs": { "post": { "operationId": "runs-sync-normdata-resident-advisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/normdata~resident-advisor-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-resident-advisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many events (or artists, venues, promoters). Leave empty for no limit (everything that matches). The Apify Free plan is always capped at 10." }, "output": { "title": "Output", "enum": [ "events", "artists", "venues", "promoters" ], "type": "string", "description": "One row per event, or one row per artist (booking email, bio, socials), venue (phone, website, capacity) or promoter (socials, website) found in those events." }, "locations": { "title": "Locations", "type": "array", "description": "A city (\"London\", \"Berlin\"), \"City, Country\" (\"Valencia, Spain\"), a country (\"Germany\"), \"Worldwide\", or \"latitude, longitude\". Cities use Resident Advisor's own city areas.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius around a city (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Search this far around each city or point instead of its Resident Advisor area. Points use 25 km when empty." }, "urls": { "title": "Resident Advisor links", "type": "array", "description": "Clubs (ra.co/clubs/5031), promoters (ra.co/promoters/123), artists (ra.co/dj/name), cities (ra.co/events/de/berlin) or single events (ra.co/events/1234567).", "items": { "type": "string" } }, "includePast": { "title": "Past events of clubs, promoters and artists", "type": "boolean", "description": "For club, promoter and artist links, also collect their past events, newest first. For places, set a start date in the past instead (the archive goes back years)." }, "genres": { "title": "Genres", "type": "array", "description": "Keep events tagged with any of these genres. Leave empty for all.", "items": { "type": "string", "enum": [ "acid", "afrobeat", "afrobeats", "afrohouse", "afrotech", "amapiano", "ambient", "bailefunk", "balearic", "ballroom", "bass", "breakbeat", "breakcore", "brokenbeat", "classical", "club", "dancehall", "deephouse", "dembow", "disco", "downtempo", "drill", "drone", "drumandbass", "dub", "dubstep", "dubtechno", "ebm", "electro", "electronica", "experimental", "footwork", "funksoul", "gabber", "garage", "ghettotech", "gqom", "grime", "guaracha", "harddrum", "hardcore", "hiphop", "house", "idm", "industrial", "italodisco", "jazz", "jungle", "krautrock", "kuduro", "kwaito", "latinbass", "minimal", "minimaltechno", "neoperreo", "newwave", "noise", "pop", "postpunk", "progressivehouse", "psytrance", "rnb", "reggaeton", "riofunk", "singeli", "techhouse", "techno", "trance", "ukfunky", "vaporwave" ], "enumTitles": [ "Acid", "Afrobeat", "Afrobeats", "Afro House", "Afro Tech", "Amapiano", "Ambient", "Baile Funk", "Balearic", "Ballroom", "Bass", "Breakbeat", "Breakcore", "Broken Beat", "Classical", "Club", "Dancehall", "Deep House", "Dembow", "Disco", "Downtempo", "Drill", "Drone", "Drum & Bass", "Dub", "Dubstep", "Dub Techno", "EBM", "Electro", "Electronica", "Experimental", "Footwork", "Funk / Soul", "Gabber", "Garage", "Ghetto Tech", "Gqom", "Grime", "Guaracha", "Hard Drum", "Hardcore", "Hip-Hop", "House", "IDM", "Industrial", "Italo Disco", "Jazz", "Jungle", "Krautrock", "Kuduro", "Kwaito", "Latin Bass", "Minimal", "Minimal Techno", "Neo Perreo", "New Wave", "Noise", "Pop", "Post-Punk", "Progressive House", "Psytrance", "R&B", "Reggaeton", "Rio Funk", "Singeli", "Tech House", "Techno", "Trance", "UK Funky", "Vaporwave" ] } }, "searchTerms": { "title": "Keywords", "type": "array", "description": "Keep events whose title, lineup, artists, venue or promoters mention any of these words, e.g. \"Boiler Room\", \"Ben UFO\". Whole words; plurals match too.", "items": { "type": "string" } }, "dateFrom": { "title": "From", "type": "string", "description": "A date (2026-11-20) or a relative one (\"-1 year\" for past events). Leave empty for today." }, "dateTo": { "title": "To", "type": "string", "description": "A date (2026-12-31) or a relative one (\"+30 days\"). Events up to this day." }, "price": { "title": "Price", "enum": [ "any", "free", "paid" ], "type": "string", "description": "Free events, paid events, or both." }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Cheapest ticket, in the event's own currency." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Cheapest ticket, in the event's own currency." }, "minAttending": { "title": "Min people attending", "minimum": 0, "type": "integer", "description": "Skip events with fewer people marked as attending on Resident Advisor." }, "onSaleOnly": { "title": "Tickets on sale only", "type": "boolean", "description": "Keep events with at least one Resident Advisor ticket on sale right now." }, "festivals": { "title": "Festivals", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "Festivals, club nights, or both." }, "picksOnly": { "title": "RA Picks only", "type": "boolean", "description": "Keep events picked by Resident Advisor's editors." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }