{
  "openapi": "3.0.1",
  "info": {
    "title": "Resident Advisor Scraper - Events, Lineups, Tickets & Clubs",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "Ip6AGa7ojfnXEzAuD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~resident-advisor-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-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/topapi~resident-advisor-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-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/topapi~resident-advisor-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-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": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "events",
              "venues",
              "promoters",
              "artists"
            ],
            "type": "string",
            "description": "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.",
            "default": "events"
          },
          "areas": {
            "title": "Cities / RA areas",
            "type": "array",
            "description": "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\".",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "RA links",
            "type": "array",
            "description": "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).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchTerms": {
            "title": "Keywords / names",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Whole countries",
            "type": "array",
            "description": "Every RA area of these countries: \"Germany\", \"uk\", \"US\", \"Netherlands\" (RA has 202 countries).",
            "items": {
              "type": "string"
            }
          },
          "worldwide": {
            "title": "Worldwide",
            "type": "boolean",
            "description": "Every RA event in the date window, all countries (splits past RA's 10,000 rows per search).",
            "default": false
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "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": {
            "title": "Clubs / venues",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "promoters": {
            "title": "Promoters",
            "type": "array",
            "description": "Promoter names, RA links or ids (\"Printworks\", \"https://ra.co/promoters/967\"). Events mode: their events. Promoters mode: their profiles.",
            "items": {
              "type": "string"
            }
          },
          "artists": {
            "title": "Artists / DJs",
            "type": "array",
            "description": "Artist names, RA slugs or links (\"Dixon\", \"boysnoize\", \"https://ra.co/dj/dixon\"). Events mode: their gigs. Artists mode: their profiles with booking contacts.",
            "items": {
              "type": "string"
            }
          },
          "eventIds": {
            "title": "Event ids",
            "type": "array",
            "description": "RA event ids (\"2532588\"). Read as they are: date and listing filters do not apply to ids and event links.",
            "items": {
              "type": "string"
            }
          },
          "dateFrom": {
            "title": "From date",
            "type": "string",
            "description": "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": {
            "title": "To date",
            "type": "string",
            "description": "Events on or before this day: 2026-12-31, \"+7\", \"+30\", \"+3 months\". Empty = no end."
          },
          "postedSince": {
            "title": "Announced since",
            "type": "string",
            "description": "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": {
            "title": "Genres",
            "type": "array",
            "description": "RA genres, any of them (RA's own filter): \"techno\", \"house\", \"Drum & Bass\", \"afrohouse\", \"disco\", \"amapiano\"... (70 genres; names or slugs).",
            "items": {
              "type": "string"
            }
          },
          "festivals": {
            "title": "Festivals",
            "enum": [
              "any",
              "only",
              "exclude"
            ],
            "type": "string",
            "description": "Keep or drop festivals (RA's own filter).",
            "default": "any"
          },
          "picksOnly": {
            "title": "RA Picks only",
            "type": "boolean",
            "description": "Only events RA's editors picked (with the pick text).",
            "default": false
          },
          "ticketedOnly": {
            "title": "Only events with RA tickets",
            "type": "boolean",
            "description": "Only events that sell tickets on RA.",
            "default": false
          },
          "onSaleOnly": {
            "title": "Tickets on sale only",
            "type": "boolean",
            "description": "Only events with at least one RA ticket tier on sale now (not sold out, not ended).",
            "default": false
          },
          "minAttending": {
            "title": "Minimum attending",
            "minimum": 0,
            "type": "integer",
            "description": "Only events with at least this many people marked as going on RA."
          },
          "price": {
            "title": "Price",
            "enum": [
              "any",
              "free",
              "paid"
            ],
            "type": "string",
            "description": "Free or paid events (from RA's ticket tiers, else the cost text).",
            "default": "any"
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Events whose highest price is at least this (event currency)."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Events whose lowest price is at most this (event currency), e.g. 15."
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "date",
              "popular",
              "newest",
              "dateDesc"
            ],
            "type": "string",
            "description": "Order of the event rows (RA sorts; a search split into date windows keeps date order).",
            "default": "date"
          },
          "includeDescription": {
            "title": "Event description",
            "type": "boolean",
            "description": "The event text (`content`). Turn off for lighter rows.",
            "default": true
          },
          "includeTicketTiers": {
            "title": "RA ticket tiers",
            "type": "boolean",
            "description": "Every RA ticket tier: name, price, currency, on sale / sold out, sale dates.",
            "default": true
          },
          "includePromoterDetails": {
            "title": "Promoter details in event rows",
            "type": "boolean",
            "description": "Each promoter's website, e-mail, socials, followers and upcoming-event count inside the event row (no extra charge).",
            "default": false
          },
          "includeArtistDetails": {
            "title": "Artist details in event rows",
            "type": "boolean",
            "description": "Each lineup artist's followers, country, website, socials and booking e-mails inside the event row (no extra charge).",
            "default": false
          },
          "includePast": {
            "title": "Past events",
            "type": "boolean",
            "description": "Clubs, promoters and artists: their past events too (most recent first). Profile rows: a past-events list.",
            "default": false
          },
          "eventsPerProfile": {
            "title": "Events per profile row",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Clubs, promoters and artists: how many upcoming events each profile row lists (0 = none).",
            "default": 10
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "Drop fields RA has no value for (null, empty text or list) from each row.",
            "default": false
          },
          "enrichArtists": {
            "title": "Artist rows for the lineups",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "maxEnrichedArtists": {
            "title": "Max lineup artist rows",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on the artist rows of the option above (empty = every lineup artist)."
          },
          "enrichContacts": {
            "title": "Website contacts (paid add-on)",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "relatedArtistsDepth": {
            "title": "Related artists depth",
            "minimum": 0,
            "maximum": 3,
            "type": "integer",
            "description": "Artists mode: also the artists RA lists as related, this many steps out (1 = their related artists).",
            "default": 0
          },
          "venueOrderBy": {
            "title": "Club / promoter order",
            "enum": [
              "POPULAR",
              "ALPHABETICAL",
              "LATEST"
            ],
            "type": "string",
            "description": "Order of a city's clubs or promoters (RA's whole directory for the city).",
            "default": "POPULAR"
          },
          "includeClosed": {
            "title": "Closed clubs",
            "type": "boolean",
            "description": "Clubs mode: also clubs RA marks as closed.",
            "default": false
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 0,
            "type": "integer",
            "description": "Most rows (events, clubs, promoters or artists) for the run. 0 = no limit.",
            "default": 50
          },
          "maxItemsPerArea": {
            "title": "Max rows per search",
            "minimum": 0,
            "type": "integer",
            "description": "Most rows per city / keyword / club / promoter / artist. Empty = no per-search limit."
          },
          "monitorMode": {
            "title": "Monitor mode (only new rows)",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "monitorChanges": {
            "title": "Also changed events",
            "type": "boolean",
            "description": "Monitor: also deliver remembered events whose title, date / time, venue, lineup, tickets or cost changed (`changeType: updated`, `changedFields`). Reads the whole scope each poll.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "A name per watch, so two schedules don't share memory.",
            "default": "resident-advisor-monitor"
          },
          "resetMonitor": {
            "title": "Reset monitor memory",
            "type": "boolean",
            "description": "Forget what earlier runs delivered (this run delivers everything again).",
            "default": false
          },
          "firstRunMode": {
            "title": "First monitor run",
            "enum": [
              "emitAll",
              "seedOnly"
            ],
            "type": "string",
            "description": "What the first monitor run does.",
            "default": "emitAll"
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "Requests to RA at the same time.",
            "default": 4
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "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.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}