{ "openapi": "3.0.1", "info": { "title": "Artist Profile By Name Resolver", "description": "Resolve a music artist, producer, or songwriter name to one Wikidata QID plus that entity's MusicBrainz, ISNI, IPI, Spotify, Discogs, and Apple Music IDs, copied from Wikidata or null, never invented, and a computed confidence. An ambiguous name returns a ranked shortlist instead of a guess.", "version": "0.0", "x-build-id": "4ZItNwG8KZj4KD0iN" }, "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 / writer / act name", "type": "string", "description": "The free-text music artist, producer, songwriter, or band name to resolve. Messy is fine: a stage name (\"Gigamesh\"), a legal name, or a band all work. The resolver anchors it to ONE Wikidata identity (QID) and returns its verified external music identifiers (MusicBrainz, ISNI, IPI, Spotify, Discogs, Apple Music). Acts with no Wikidata record, or names that are not music entities, return an honest no-match for the $0.02 run 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 are sent to the ranking model. The output row lists the full scored candidate pool. Never changes scoring or the tie test. 1 to 10.", "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 (public Store preview only)", "type": "boolean", "description": "Charges no PPE event (ordinary Apify platform compute/storage/egress still applies). Valid ONLY for the exact default example above (name \"Gigamesh\", no hints, maxCandidates 5, includeSources true). Any other input with dryRun true is rejected before any charge, lookup, or state read. Leave this off to run your own real, billed lookup.", "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 } } }, "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 } } } } } } } } } }