{ "openapi": "3.0.1", "info": { "title": "Shazam Charts Scraper", "description": "[💰 $0.99 / 1K] Extract trending tracks from Shazam charts — global Top 200, country, city, and genre charts. Get rank, title, artist, album, cover art, genre, ISRC, release date, and Apple Music links. Track what the world is discovering in music.", "version": "1.0", "x-build-id": "j3ZaHucO8LZhCyoAe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~shazam-charts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-shazam-charts-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~shazam-charts-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-shazam-charts-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~shazam-charts-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-shazam-charts-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": { "chartType": { "title": "Chart Type", "enum": [ "top", "viral" ], "type": "string", "description": "Which Shazam chart to pull. 'Top Tracks' is the standard most-Shazamed chart. 'Viral / Rising' surfaces fast-rising tracks — note Viral charts exist for whole countries and the Global (World) chart only, not for cities or genres, so any city or genre you add is collected as a Top Tracks chart." }, "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "Country charts to collect. Choose one or more countries, or pick 'Global (World)' for the worldwide chart. Leave empty to default to the Global chart.", "items": { "type": "string", "enum": [ "world", "US", "GB", "CA", "AU", "NZ", "IE", "FR", "DE", "ES", "IT", "NL", "BE", "PT", "CH", "AT", "SE", "NO", "DK", "FI", "PL", "GR", "CZ", "HU", "RO", "HR", "BG", "UA", "BY", "RU", "AZ", "KZ", "UZ", "JP", "KR", "CN", "SG", "MY", "TH", "ID", "PH", "VN", "IN", "BR", "MX", "AR", "CL", "CO", "PE", "UY", "VE", "CR", "AE", "SA", "IL", "EG", "DZ", "MA", "TN", "ZA", "NG", "GH", "KE", "CI", "SN", "CM", "TZ", "UG", "MZ", "ZM" ], "enumTitles": [ "Global (World)", "United States", "United Kingdom", "Canada", "Australia", "New Zealand", "Ireland", "France", "Germany", "Spain", "Italy", "Netherlands", "Belgium", "Portugal", "Switzerland", "Austria", "Sweden", "Norway", "Denmark", "Finland", "Poland", "Greece", "Czechia", "Hungary", "Romania", "Croatia", "Bulgaria", "Ukraine", "Belarus", "Russia", "Azerbaijan", "Kazakhstan", "Uzbekistan", "Japan", "South Korea", "China", "Singapore", "Malaysia", "Thailand", "Indonesia", "Philippines", "Vietnam", "India", "Brazil", "Mexico", "Argentina", "Chile", "Colombia", "Peru", "Uruguay", "Venezuela", "Costa Rica", "United Arab Emirates", "Saudi Arabia", "Israel", "Egypt", "Algeria", "Morocco", "Tunisia", "South Africa", "Nigeria", "Ghana", "Kenya", "Ivory Coast", "Senegal", "Cameroon", "Tanzania", "Uganda", "Mozambique", "Zambia" ] } }, "cities": { "title": "Cities", "type": "array", "description": "Optional city-level charts (e.g. 'London', 'New York City', 'Tokyo'). City charts show what is trending locally. City names are matched against the cities Shazam publishes (168 cities across the supported countries) — a name with no matching city chart is skipped with a note. Leave empty to skip city charts.", "items": { "type": "string" } }, "genres": { "title": "Genres", "uniqueItems": true, "type": "array", "description": "Optional genre filter. When set, a genre chart is collected for each selected country + genre (e.g. United States + Pop). Note: each country only offers a subset of these genres — combinations a country doesn't publish are skipped automatically. For the Global (World) chart, all genres below are available. Leave empty to collect the all-genres chart. Genre charts apply to Top Tracks only (Viral is country/world-wide only).", "items": { "type": "string", "enum": [ "pop", "hip-hop-rap", "dance", "electronic", "house", "rock", "alternative", "latin", "randb-soul", "country", "k-pop", "afrobeats", "french-pop", "reggae-dancehall", "singer-songwriter", "film-tv-and-stage", "worldwide" ], "enumTitles": [ "Pop", "Hip-Hop / Rap", "Dance", "Electronic", "House", "Rock", "Alternative", "Latin", "R&B / Soul", "Country", "K-Pop", "Afrobeats", "French Pop", "Reggae / Dancehall", "Singer-Songwriter", "Film, TV & Stage", "Worldwide" ] } }, "maxTracksPerChart": { "title": "Max Tracks Per Chart", "minimum": 0, "type": "integer", "description": "Maximum number of tracks to collect from each chart, counted from the top of the ranking down. Shazam Top charts cap at around 200 tracks; Viral and genre charts are shorter (around 25-100). Set to 0 to collect every available track in each chart. You pay per track returned.", "default": 200 }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "ja", "ko", "zh-CN", "ru", "ar", "tr" ], "type": "string", "description": "Language for track and artist text where Shazam provides localized values." } } }, "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 } } } } } } } } } }