{ "openapi": "3.0.1", "info": { "title": "Apple Music & iTunes Scraper", "description": "Scrape songs, albums, artists, podcasts and charts from Apple Music and iTunes. Free public API, no key needed. Search, lookup by ID, get top charts, artist discographies, album tracks. Supports music, podcasts, movies and audiobooks.", "version": "0.1", "x-build-id": "CZfE0GiJGZKjeZaGs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rupom888~apple-music-itunes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rupom888-apple-music-itunes-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/rupom888~apple-music-itunes-scraper/runs": { "post": { "operationId": "runs-sync-rupom888-apple-music-itunes-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/rupom888~apple-music-itunes-scraper/run-sync": { "post": { "operationId": "run-sync-rupom888-apple-music-itunes-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": { "scrapeType": { "title": "Scrape Type", "enum": [ "search", "lookup", "top_charts", "artist_discography", "album_tracks" ], "type": "string", "description": "What to scrape: search iTunes, lookup by ID, get top charts, artist discography, or album tracks.", "default": "search" }, "query": { "title": "Search Query", "type": "string", "description": "Keywords to search for songs, artists, albums, or podcasts on iTunes." }, "mediaType": { "title": "Media Type", "enum": [ "music", "podcast", "audiobook", "shortFilm", "tvShow", "movie", "ebook", "all" ], "type": "string", "description": "Type of media to search for on iTunes.", "default": "music" }, "entity": { "title": "Entity Type", "enum": [ "song", "album", "artist", "musicVideo", "podcast", "podcastEpisode", "audiobook", "tvEpisode", "movie" ], "type": "string", "description": "Specific type of result to return (must match the media type).", "default": "song" }, "chartType": { "title": "Chart Type", "enum": [ "songs", "albums", "music-videos", "podcasts" ], "type": "string", "description": "Which top chart to fetch from Apple Music.", "default": "songs" }, "ids": { "title": "iTunes IDs", "type": "array", "description": "List of iTunes track, album, or artist IDs to look up directly.", "items": { "type": "string" } }, "artistId": { "title": "Artist ID", "type": "string", "description": "iTunes artist ID for fetching full discography." }, "albumId": { "title": "Album ID", "type": "string", "description": "iTunes album/collection ID for fetching all tracks." }, "country": { "title": "Store Country", "type": "string", "description": "Two-letter iTunes Store country code (e.g. us, gb, de, au, jp).", "default": "us" }, "limit": { "title": "Results Limit", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of results to return (max 200 for search, 100 for charts).", "default": 50 }, "explicit": { "title": "Include Explicit Content", "type": "boolean", "description": "When enabled, include explicit content in results.", "default": true } } }, "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 } } } } } } } } } }