# Songkick Scraper (`crawlergang/songkick-scraper`) Actor Scrape Songkick for concerts, events, artist gigographies, and upcoming shows. Search by artist name, city, or festival which returns structured event data with venue, date, ticket, and artist details. - **URL**: https://apify.com/crawlergang/songkick-scraper.md - **Developed by:** [Crawler Gang](https://apify.com/crawlergang) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 11 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Songkick Scraper Extract concerts, tour dates, and artist information from [Songkick.com](https://www.songkick.com) — no API key required. Scrapes public HTML pages and internal JSON APIs to deliver structured event and artist data. ### What does Songkick Scraper do? Songkick Scraper is a production-ready Apify actor that collects concerts and live event data from Songkick. You can search by keyword, pull all upcoming or past tour dates for a specific artist, or retrieve detailed artist profiles. All output is clean, omit-empty JSON — no null fields, no empty strings. #### Key features - **Search mode**: Find events by keyword or artist name across all of Songkick - **Artist concerts mode**: Pull full gigography (past) or upcoming calendar for any artist - **Artist info mode**: Retrieve artist profiles including follower counts, genres, and upcoming event counts - **Date range filtering**: Narrow results to any `dateFrom` / `dateTo` window - **Up to 1,000 items per run**: Configurable `maxItems` (1–1,000) - **No API key needed**: Works on the Apify free plan with zero credentials ### Input | Field | Type | Description | Default | |---|---|---|---| | `mode` | Select | Operation mode: `search`, `artistConcerts`, or `artistInfo` | `search` | | `searchQuery` | String | Search keyword or artist name (used in `search` mode) | — | | `artistName` | String | Artist name for `artistConcerts` / `artistInfo` modes | — | | `artistUrl` | String | Songkick artist URL (alternative to `artistName`) | — | | `concertType` | Select | `gigography` (past) or `calendar` (upcoming) | `gigography` | | `dateFrom` | String | Filter events from this date (`YYYY-MM-DD`) | — | | `dateTo` | String | Filter events up to this date (`YYYY-MM-DD`) | — | | `maxItems` | Integer | Maximum number of records to return (1–1,000) | `50` | #### Input example ```json { "mode": "artistConcerts", "artistName": "Radiohead", "concertType": "gigography", "dateFrom": "2020-01-01", "maxItems": 100 } ```` #### Mode: `search` Search Songkick by keyword. Returns matching events from the universal search API. ```json { "mode": "search", "searchQuery": "radiohead", "maxItems": 50 } ``` #### Mode: `artistConcerts` Scrape all concerts for a specific artist. Use `concertType: "gigography"` for past shows and `concertType: "calendar"` for upcoming dates. ```json { "mode": "artistConcerts", "artistName": "Metallica", "concertType": "calendar", "maxItems": 200 } ``` #### Mode: `artistInfo` Retrieve artist profile data: name, genres, hometown, Songkick URL, upcoming event count, and more. ```json { "mode": "artistInfo", "artistName": "Pearl Jam" } ``` ### Output #### Event record (modes: `search`, `artistConcerts`) ```json { "recordType": "event", "eventId": "40886271", "eventName": "Radiohead", "eventDate": "2018-07-07", "eventTime": "19:30:00", "startTime": "2018-07-07T19:30:00", "eventStatus": "scheduled", "attendanceMode": "in_person", "artistName": "Radiohead", "artistId": "254480", "artistUrl": "https://www.songkick.com/artists/254480-radiohead", "bandsintownUrl": "https://www.songkick.com/concerts/40886271-radiohead-at-td-garden", "venueName": "TD Garden", "venueCity": "Boston", "venueRegion": "MA", "venueCountry": "US", "venueStreet": "100 Legends Way", "venuePostalCode": "02114", "venueLatitude": 42.3662, "venueLongitude": -71.0621, "ticketUrl": "https://www.songkick.com/tickets/40886271", "ticketStatus": "available", "lineup": ["Radiohead", "Jon Hopkins"], "isFestival": false, "scrapedAt": "2025-08-22T14:30:00+00:00" } ``` #### Artist record (mode: `artistInfo`) ```json { "recordType": "artist", "artistName": "Radiohead", "artistId": "254480", "artistUrl": "https://www.songkick.com/artists/254480-radiohead", "genres": ["Alternative Rock", "Art Rock"], "hometown": "Abingdon, UK", "followers": 2800000, "description": "Radiohead are an English rock band...", "upcomingEventCount": 0, "hasUpcomingEvents": false, "scrapedAt": "2025-08-22T14:30:00+00:00" } ``` #### Output fields reference | Field | Type | Description | |---|---|---| | `recordType` | String | `"event"` or `"artist"` | | `eventId` | String | Songkick event ID | | `eventName` | String | Event/concert title | | `eventDate` | String | Date in `YYYY-MM-DD` format | | `eventTime` | String | Local start time (`HH:MM:SS`) | | `startTime` | String | Full ISO datetime | | `eventStatus` | String | `scheduled`, `cancelled`, or `postponed` | | `attendanceMode` | String | `in_person` or `online` | | `artistName` | String | Primary performer name | | `artistId` | String | Songkick artist numeric ID | | `artistUrl` | String | Songkick artist page URL | | `bandsintownUrl` | String | Songkick event page URL | | `venueName` | String | Venue name | | `venueCity` | String | City name | | `venueRegion` | String | State/region/province | | `venueCountry` | String | ISO country code | | `venueStreet` | String | Street address | | `venuePostalCode` | String | Postal/ZIP code | | `venueLatitude` | Float | Venue latitude | | `venueLongitude` | Float | Venue longitude | | `ticketUrl` | String | Ticket purchase link | | `ticketStatus` | String | `available`, `sold_out`, or `pre_sale` | | `lineup` | Array | All performers (primary + supports) | | `isFestival` | Boolean | `true` if event name contains "festival" or "fest" | | `genres` | Array | Artist genres (artist mode only) | | `hometown` | String | Artist hometown (artist mode only) | | `followers` | Integer | Songkick follower count (artist mode only) | | `description` | String | Artist bio (artist mode only) | | `upcomingEventCount` | Integer | Number of upcoming events (artist mode only) | | `hasUpcomingEvents` | Boolean | Whether artist has upcoming events (artist mode only) | | `scrapedAt` | String | ISO timestamp when record was scraped | ### FAQs #### Does this require a Songkick API key? No. This scraper uses Songkick's public HTML pages and internal JSON endpoints. No API key, login, or cookies are needed. #### How many concerts can I scrape? Up to 1,000 per run via the `maxItems` parameter. For artists with large gigographies, pagination is handled automatically. #### What is the difference between `gigography` and `calendar`? - `gigography` returns past concerts (all historical shows) - `calendar` returns upcoming scheduled events #### Can I filter by date? Yes. Use `dateFrom` and/or `dateTo` in `YYYY-MM-DD` format to restrict results to a specific time range. #### Is the data from official Songkick APIs? The scraper extracts `application/ld+json` schema.org `MusicEvent` blocks embedded in public Songkick HTML pages, which are the most reliable and structured form of the data. Artist resolution uses Songkick's internal universal search endpoint. #### What happens if an artist has no events? If no events are found (e.g., artist is not currently touring), the run completes with zero records and a status message explaining the result. #### Can I scrape multiple artists in one run? Currently the actor processes one artist per run. To scrape multiple artists in parallel, create multiple runs using the Apify API or Scheduler. #### Is there a rate limit? The scraper includes automatic retry logic with exponential backoff for 429 (Too Many Requests) and 5xx errors. For very large gigographies, please allow extra time. ### Data source All data is sourced from [Songkick.com](https://www.songkick.com) public pages. Songkick is a concert discovery platform with data on millions of past and upcoming shows worldwide. # Actor input Schema ## `mode` (type: `string`): What to scrape. 'search' finds concerts/artists by query. 'artistConcerts' gets all concerts for a specific artist. 'artistInfo' gets artist profile data. ## `searchQuery` (type: `string`): Artist name, band name, or event title to search for (mode=search). ## `artistName` (type: `string`): Artist name to look up (mode=artistConcerts or artistInfo). Used to find the artist and fetch their page. ## `artistUrl` (type: `string`): Direct Songkick artist URL (e.g. https://www.songkick.com/artists/253846-radiohead). Overrides artistName when provided. ## `concertType` (type: `string`): For artistConcerts: get upcoming (calendar) or past (gigography) concerts. ## `dateFrom` (type: `string`): Only include events on or after this date. ## `dateTo` (type: `string`): Only include events on or before this date. ## `maxItems` (type: `integer`): Maximum number of records to emit. ## Actor input object example ```json { "mode": "search", "searchQuery": "radiohead", "concertType": "gigography", "maxItems": 50 } ``` # Actor output Schema ## `events` (type: `string`): Dataset containing all scraped Songkick concerts and events. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "searchQuery": "radiohead", "concertType": "gigography", "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlergang/songkick-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "searchQuery": "radiohead", "concertType": "gigography", "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlergang/songkick-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "searchQuery": "radiohead", "concertType": "gigography", "maxItems": 50 }' | apify call crawlergang/songkick-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlergang/songkick-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Songkick Scraper", "description": "Scrape Songkick for concerts, events, artist gigographies, and upcoming shows. Search by artist name, city, or festival which returns structured event data with venue, date, ticket, and artist details.", "version": "1.0", "x-build-id": "W3ZxfbTtJnveVxbMz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlergang~songkick-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlergang-songkick-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/crawlergang~songkick-scraper/runs": { "post": { "operationId": "runs-sync-crawlergang-songkick-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/crawlergang~songkick-scraper/run-sync": { "post": { "operationId": "run-sync-crawlergang-songkick-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "artistConcerts", "artistInfo" ], "type": "string", "description": "What to scrape. 'search' finds concerts/artists by query. 'artistConcerts' gets all concerts for a specific artist. 'artistInfo' gets artist profile data.", "default": "search" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Artist name, band name, or event title to search for (mode=search)." }, "artistName": { "title": "Artist Name", "type": "string", "description": "Artist name to look up (mode=artistConcerts or artistInfo). Used to find the artist and fetch their page." }, "artistUrl": { "title": "Artist URL", "type": "string", "description": "Direct Songkick artist URL (e.g. https://www.songkick.com/artists/253846-radiohead). Overrides artistName when provided." }, "concertType": { "title": "Concert Type", "enum": [ "gigography", "calendar" ], "type": "string", "description": "For artistConcerts: get upcoming (calendar) or past (gigography) concerts.", "default": "gigography" }, "dateFrom": { "title": "Date From (YYYY-MM-DD)", "type": "string", "description": "Only include events on or after this date." }, "dateTo": { "title": "Date To (YYYY-MM-DD)", "type": "string", "description": "Only include events on or before this date." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of records to emit.", "default": 50 } } }, "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 } } } } } } } } } } ```