{ "openapi": "3.0.1", "info": { "title": "Genius Lyrics Scraper", "description": "[💰 $2.5 / 1K] Extract song lyrics, metadata, credits, streaming links, and artist profiles from Genius. Search by keyword or paste artist and song URLs.", "version": "1.0", "x-build-id": "nWZkaNcgyuCrKGU6M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~genius-lyrics-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-genius-lyrics-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~genius-lyrics-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-genius-lyrics-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~genius-lyrics-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-genius-lyrics-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": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Song titles, artist names, or lyric fragments to search on Genius (e.g. 'HUMBLE Kendrick Lamar' or 'we all we got'). Each query runs independently and returns matching songs. Leave empty if you only want to use artist or song URLs.", "items": { "type": "string" } }, "artistUrls": { "title": "Artist URLs", "type": "array", "description": "Genius artist-page URLs to pull a full discography, e.g. 'https://genius.com/artists/Drake'. Every song on the artist's catalog is collected, up to the limit below.", "items": { "type": "string" } }, "songUrls": { "title": "Song URLs", "type": "array", "description": "Direct Genius song-page URLs for exact songs you already know, e.g. 'https://genius.com/Kendrick-lamar-humble-lyrics'. Each URL produces one song row.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum Songs per Source", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How many songs to collect per search query or per artist. Set to 0 for all available songs. Recommended: 50-500 to keep runs fast and costs predictable. Hard upper bound is 1,000 per source.", "default": 50 }, "includeLyrics": { "title": "Include Lyrics", "type": "boolean", "description": "Extract the full plain-text lyrics for every song. Turn this off for a faster, smaller run that returns metadata, credits, and links only (roughly twice as fast).", "default": true }, "includeArtistProfile": { "title": "Include Artist Profile", "type": "boolean", "description": "When you provide an artist URL or search for an artist, also emit a standalone artist-profile row (recordType 'artist') with followers, verified status, biography, and social handles. Off by default to keep the dataset focused on songs.", "default": false }, "language": { "title": "Language", "enum": [ "any", "en", "es", "fr", "de", "it", "pt", "nl", "ru", "ja", "ko", "zh-CN" ], "type": "string", "description": "Keep songs only in a specific language. Leave on 'Any language' (the default) to return every song regardless of language. Picking a specific language drops songs detected in other languages.", "default": "any" } } }, "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 } } } } } } } } } }