Rave Finder
Pricing
Pay per usage
You can access the Rave Finder programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "S4bsTdmB8bTSeeDqP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kat_raszka~rave-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kat_raszka-rave-finder", "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/kat_raszka~rave-finder/runs": { "post": { "operationId": "runs-sync-kat_raszka-rave-finder", "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/kat_raszka~rave-finder/run-sync": { "post": { "operationId": "run-sync-kat_raszka-rave-finder", "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", "required": [ "city" ], "properties": { "city": { "title": "City", "type": "string", "description": "Czech city to search near, e.g. \"Brno\"." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum distance from the city center to include events, in kilometers.", "default": 30 }, "genres": { "title": "Genres", "type": "array", "description": "Electronic music genres to include. \"Electronic (general)\" covers events that are clearly electronic/DJ music but don't name a specific genre in their own listing (e.g. a branded party or festival satellite event) — kept when the source itself is dedicated to electronic music.", "items": { "type": "string", "enum": [ "techno", "house", "drum_and_bass", "electronic" ], "enumTitles": [ "Techno", "House", "Drum & Bass", "Electronic (general)" ] }, "default": [ "techno", "house", "drum_and_bass", "electronic" ] }, "dateRangeDays": { "title": "Date range (days)", "minimum": 1, "maximum": 180, "type": "integer", "description": "Only include events happening within this many days from now.", "default": 30 }, "dateFrom": { "title": "From date", "type": "string", "description": "Start of the window to search, as YYYY-MM-DD. Use this with To date for a trip — \"I'm in Prague 12-15 September\" is dateFrom 2026-09-12, dateTo 2026-09-15. Leave both empty to search the next few days instead, per Date range (days)." }, "dateTo": { "title": "To date", "type": "string", "description": "End of the window to search, as YYYY-MM-DD. Inclusive." }, "includeFacebookVenuePages": { "title": "Include Facebook events from nearby venue pages", "type": "boolean", "description": "Fetch events directly from the Facebook pages of venues already found to be in range, instead of using Facebook's event search. On by default: verified live that a venue page's events tab returns real dated events with coordinates, and cost scales with the number of nearby venues rather than with search noise. Shares the maxFacebookEvents cap.", "default": true }, "facebookPages": { "title": "Extra Facebook pages or events", "type": "array", "description": "Facebook page or event URLs to check in addition to the built-in venues. Use this when you know a local promoter or venue the Actor doesn't: around small towns the promoter creates the event and only tags the venue, so the venue's own page won't list it. Paste either a page URL (https://www.facebook.com/somepromoter) or a single event URL — both work. Each page costs one Actor call and shares the maxFacebookEvents budget.", "default": [], "items": { "type": "string" } }, "maxFacebookEvents": { "title": "Max Facebook events", "minimum": 0, "type": "integer", "description": "Caps how many Facebook events are fetched, to control cost (apify/facebook-events-scraper runs at roughly $0.013 per event). Kept low: Facebook's event search OR-matches, so a query like \"drum and bass Havířov\" also returns every unrelated event in that town — yoga classes, board-game nights — each of which costs the same per-event fee before this Actor's genre filter discards it.", "default": 20 }, "maxMapsVenues": { "title": "Max Maps-discovered venues per search term", "minimum": 0, "type": "integer", "description": "Discovers club-like venues near the city via Google Maps (compass/crawler-google-places, ~$1.50 per 1,000 places), so cities outside the curated seed list still get coverage. Caps results per search term; set to 0 to disable this source entirely. Kept low by default: each discovered venue costs an Actor call to crawl, and in practice most results are dance schools, restaurants and bars rather than electronic venues.", "default": 5 } } }, "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 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Rave Finder from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: