{ "openapi": "3.0.1", "info": { "title": "Transfermarkt Scraper - Squads, Market Values, Transfers", "description": "Football data from public Transfermarkt pages: club squads (position, age, nationality, market value, contract end), league club tables with total market value, and transfers with fees. Monitoring mode returns only new transfers and changed values or contracts.", "version": "0.1", "x-build-id": "eV4Ri29Hp3JlOOaWl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~transfermarkt-players-transfers-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-transfermarkt-players-transfers-monitor", "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/neverempty~transfermarkt-players-transfers-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-transfermarkt-players-transfers-monitor", "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/neverempty~transfermarkt-players-transfers-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-transfermarkt-players-transfers-monitor", "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": "League pages on Transfermarkt, as a URL or as the competition code at the end of the URL (GB1 = Premier League, ES1 = LaLiga, L1 = Bundesliga, IT1 = Serie A, FR1 = Ligue 1). Each league returns one row per club with squad size, average age, foreigners, average and total market value. Turn on \"Also read every club's squad\" to get the players too.", "items": { "type": "string" } }, "clubs": { "title": "Clubs", "type": "array", "description": "Club pages on Transfermarkt, as a URL or as the club number in the URL (281 = Manchester City, the number after /verein/). Each club returns one row per player of the current squad (position, date of birth, age, nationality, height, foot, joined, signed from, contract end, market value) and, unless turned off below, one row per arrival and departure of the current season.", "items": { "type": "string" } }, "players": { "title": "Players", "type": "array", "description": "Player pages on Transfermarkt, as a URL or as the player number in the URL (418560, the number after /spieler/). Each player returns one row with current club, contract end and market value.", "items": { "type": "string" } }, "latestTransfers": { "title": "Latest transfers worldwide", "type": "boolean", "description": "Read the \"Latest transfers\" page of Transfermarkt: the newest transfers entered on the site (about 18), with player, club left, club joined and fee. The page shows no transfer date.", "default": false }, "leagueSquads": { "title": "Also read every club's squad (leagues)", "type": "boolean", "description": "For every league given above, also read the squad of each of its clubs (one request per club, 2.5 seconds apart), so a 20-club league returns about 20 club rows and 500 player rows.", "default": false }, "includeClubTransfers": { "title": "Include arrivals and departures (clubs)", "type": "boolean", "description": "For every club, also read its transfers page of the current season (one more request per club) and return one row per arrival and departure with the other club and the fee. Turn off to get player rows only.", "default": true }, "maxRows": { "title": "Maximum rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The run stops reading and returning rows at this number (players, clubs and transfers together). Not used in monitoring mode, where every change is returned.", "default": 500 }, "monitoringMode": { "title": "Monitoring mode (only changes)", "type": "boolean", "description": "The first run of a league, club or player remembers its state and returns nothing for it. Later runs return only: new transfers, players whose market value changed, players whose contract end changed, new squad members, and clubs whose total market value changed, each with the previous value. A target with no change returns one free note row and is charged as one target-checked event.", "default": false }, "resetMonitoringState": { "title": "Forget the remembered state", "type": "boolean", "description": "Clears everything monitoring mode remembers (for all targets) before this run.", "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 } } } } } } } } } }