{ "openapi": "3.0.1", "info": { "title": "Bandsintown Scraper", "description": "[💰 $1 / 1K] Scrape Bandsintown concerts, tour dates & artist profiles. Look up many artists by name or ID, get upcoming, past, or all events with venue locations, lineups & ticket links. No account or API key needed.", "version": "1.0", "x-build-id": "7gcgYhFISfPCrHhY5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~bandsintown-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-bandsintown-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/solidcode~bandsintown-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-bandsintown-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/solidcode~bandsintown-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-bandsintown-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": { "artists": { "title": "Artists", "type": "array", "description": "Artists to look up, one per line. Enter an artist name (e.g. Radiohead, Metallica) or a Bandsintown numeric artist ID (e.g. 25874). Numeric entries are treated as IDs and skip the name lookup; everything else is searched by name.", "items": { "type": "string" } }, "queryType": { "title": "What to fetch", "enum": [ "events", "artist", "both" ], "type": "string", "description": "Choose what to return for each artist: just the artist profile, just their events, or both.", "default": "events" }, "includeEventDetails": { "title": "Include full event details", "type": "boolean", "description": "Add precise location (latitude/longitude, country, region), the full event lineup, and structured ticket offers for each event. This is best-effort on very large runs — any event whose details can't be loaded still comes through with its basic venue and ticket info. Turning this on adds a small extra per-enriched-event fee (see Pricing); leave it off for a fast list of events with basic venue and ticket info at the standard per-result price.", "default": false }, "dateFilter": { "title": "Which events", "enum": [ "upcoming", "past", "all", "custom" ], "type": "string", "description": "Filter events by date. Use 'Custom range' together with the start and end dates below to pull a specific window.", "default": "upcoming" }, "dateFrom": { "title": "Range start date", "type": "string", "description": "Start of the custom date range (YYYY-MM-DD). Only used when 'Which events' is set to 'Custom date range'. Leave empty for no lower bound. Dates are compared against each show's local start date (the venue's own time zone), so events are kept or excluded by their date where the concert happens." }, "dateTo": { "title": "Range end date", "type": "string", "description": "End of the custom date range (YYYY-MM-DD), inclusive. Only used when 'Which events' is set to 'Custom date range'. Leave empty for no upper bound. Dates are compared against each show's local start date (the venue's own time zone), so events are kept or excluded by their date where the concert happens." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of event rows to collect across all artists. Default 100 — increase for bigger tours, or set to 0 for no cap (an internal safety ceiling still applies). The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots. Artist profile rows do not count against this limit.", "default": 100 } } }, "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 } } } } } } } } } }