{ "openapi": "3.0.1", "info": { "title": "Transfermarkt Scraper - Market Values, Squads and Transfers", "description": "Transfermarkt scraper for league and club squads: player market values in EUR, position, age, nationality, height, foot, contract end, joined date, signed from and transfer fee. Monitor mode flags market value changes, new signings and departures between runs. Plain HTTP, no login.", "version": "1.0", "x-build-id": "wITWY9sbGQZs5VFno" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~transfermarkt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-transfermarkt-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/kamerozkan~transfermarkt-scraper/runs": { "post": { "operationId": "runs-sync-kamerozkan-transfermarkt-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/kamerozkan~transfermarkt-scraper/run-sync": { "post": { "operationId": "run-sync-kamerozkan-transfermarkt-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": { "leagues": { "title": "Leagues", "type": "array", "description": "Transfermarkt competition codes or league URLs. Every club of the league is read (see Max clubs per league). Examples: GB1 (Premier League), L1 (Bundesliga), ES1 (LaLiga), IT1 (Serie A), FR1 (Ligue 1), NL1, PO1, TR1, GB2, or https://www.transfermarkt.com/premier-league/startseite/wettbewerb/GB1", "default": [ "GB1" ], "items": { "type": "string" } }, "clubs": { "title": "Clubs", "type": "array", "description": "Club URLs or numeric Transfermarkt club ids, for example https://www.transfermarkt.com/fc-bayern-munchen/kader/verein/27 or 27. Read in addition to the leagues.", "items": { "type": "string" } }, "season": { "title": "Season (start year)", "minimum": 1990, "maximum": 2030, "type": "integer", "description": "Season start year, for example 2026 for 26/27 or 2025 for 25/26. Leave empty for the current season." }, "maxPlayers": { "title": "Max players", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many player rows. You are charged per player row, so this also caps the cost of the run. A full Premier League season is about 550 players.", "default": 100 }, "maxClubsPerLeague": { "title": "Max clubs per league", "minimum": 0, "maximum": 40, "type": "integer", "description": "Read only the first N clubs of each league (ordered by total market value). 0 means all clubs.", "default": 0 }, "minMarketValueEur": { "title": "Min market value (EUR)", "minimum": 0, "type": "integer", "description": "Only keep players with at least this market value in euros, for example 10000000 for 10 million. Players below it are not charged." }, "trackChanges": { "title": "Track market value changes", "type": "boolean", "description": "Remember market values per club between runs and add previousMarketValueEur, marketValueChangeEur and isNewInSquad to each row. Departed players are listed in the OUTPUT record. Schedule the actor to get a transfer and market value monitor.", "default": true }, "onlyChanges": { "title": "Only changed players", "type": "boolean", "description": "On repeat runs, output (and charge) only players whose market value changed or who are new in the squad.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy. By default the run uses residential proxy (Transfermarkt blocks most datacenter IPs); choose proxy groups here to override.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }