{ "openapi": "3.0.1", "info": { "title": "Artist Profile By Name Resolver", "description": "Resolve a free-text music artist, producer, songwriter, or band name to one Wikidata QID plus verified MusicBrainz, ISNI, IPI, Spotify, Discogs, and Apple Music IDs, ranked candidates, a computed confidence, and an honest no-match for names the public record does not cover.", "version": "0.0", "x-build-id": "ss2Q7OPaQ8YEjd0Ms" }, "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 } } } } } } } } } }