{ "openapi": "3.0.1", "info": { "title": "Artist Lookup by Name: Spotify, MusicBrainz & ISNI IDs", "description": "Look up a music artist or songwriter by name and get the Spotify artist ID, MusicBrainz ID, ISNI, Discogs and Apple Music IDs from the matching Wikidata record, each copied or left empty, plus a confidence score. Ambiguous names return a ranked shortlist; unknown names return an explicit no-match.", "version": "0.0", "x-build-id": "kgyd845jm77NSoqPf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yungstentech~artist-profile-by-name/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yungstentech-artist-profile-by-name", "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/yungstentech~artist-profile-by-name/runs": { "post": { "operationId": "runs-sync-yungstentech-artist-profile-by-name", "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/yungstentech~artist-profile-by-name/run-sync": { "post": { "operationId": "run-sync-yungstentech-artist-profile-by-name", "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": [ "name" ], "properties": { "name": { "title": "Artist, band, or songwriter name", "type": "string", "description": "The music artist, producer, songwriter, or band name to look up. Messy is fine: a stage name (\"Gigamesh\") and a legal name both work. This Actor matches the name to one Wikidata record and returns that record's own music identifiers (MusicBrainz, ISNI, IPI, Spotify, Discogs, Apple Music). A name with no Wikidata record, or one that is not a music entity, returns an explicit no-match for the $0.02 request fee only." }, "hints": { "title": "Optional hints", "type": "object", "description": "Optional context to sharpen selection and enrichment. Fields (all optional, all checked against Wikidata statements): country (P27/P495, an English label or ISO alpha-2 like \"US\"), genre (P136), role (P106, e.g. \"producer\"), knownWork (P800, a notable work title), externalUrl (a Spotify / MusicBrainz / Discogs / Apple Music / Wikidata URL matched against the candidate's identifiers)." }, "maxCandidates": { "title": "Max candidates", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many candidates go to the ranking model, 1 to 10. It never changes scoring or the tie test, and the output row still lists the full scored candidate pool.", "default": 5 }, "includeSources": { "title": "Include evidence URLs", "type": "boolean", "description": "Include Wikidata evidence URLs on ranked candidates and citation URLs on the synthesized enrichment fields. Turn off for a leaner row without source links.", "default": true }, "dryRun": { "title": "Dry run (no pay-per-event charge, Gigamesh sample only)", "type": "boolean", "description": "Charges no pay-per-event fee, not even the request fee. Ordinary Apify platform compute, storage, and egress still apply. Valid only for the prefilled sample: name \"Gigamesh\", hints empty, maxCandidates 5, includeSources true. Any other input with dryRun true is rejected before any charge, lookup, or state read. Leave this off to run a real, billed lookup on your own input.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }