{ "openapi": "3.0.1", "info": { "title": "German Football Results & Tables", "description": "Extracts German football matches, scores, scorers, standings, teams, points, and rounds. Export data, run via API, schedule and monitor runs, or integrate with other tools.", "version": "0.1", "x-build-id": "jcHbCHOTfIRjUKwxa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trovevault~german-football-results-tables/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trovevault-german-football-results-tables", "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/trovevault~german-football-results-tables/runs": { "post": { "operationId": "runs-sync-trovevault-german-football-results-tables", "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/trovevault~german-football-results-tables/run-sync": { "post": { "operationId": "run-sync-trovevault-german-football-results-tables", "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": [ "leagues" ], "properties": { "leagues": { "title": "Competitions", "type": "array", "description": "German football competitions to retrieve. The actor fetches fixtures, scores, and standings for each selected competition, then returns a normalized dataset across men's and women's football. Select one league for a compact run or several competitions to compare Bundesliga, 2. Bundesliga, 3. Liga, DFB-Pokal, Frauen-Bundesliga, and 2. Frauen-Bundesliga in one dataset. Standings apply to league competitions only; DFB-Pokal returns match rows.", "items": { "type": "string", "enum": [ "bundesliga", "2-bundesliga", "3-liga", "dfb-pokal", "frauen-bundesliga", "2-frauen-bundesliga" ], "enumTitles": [ "Bundesliga", "2. Bundesliga", "3. Liga", "DFB-Pokal", "Frauen-Bundesliga", "2. Frauen-Bundesliga" ] } }, "season": { "title": "Season Start Year", "minimum": 2003, "maximum": 2030, "type": "integer", "description": "Season start year to retrieve. German football seasons use the first year of the season, so 2025 means the 2025/2026 season for most competitions. Use a recent year such as 2024 or 2025 for the most complete data. Older seasons may be less complete depending on community-maintained records.", "default": 2025 }, "round": { "title": "Round", "minimum": 1, "maximum": 60, "type": "integer", "description": "Optional round or matchday number to retrieve for match rows. When filled, the actor returns only that matchday or cup round, for example 1 for opening matchday or an early DFB-Pokal round. Leave blank to retrieve all matches in the selected season. Standings are season tables and are not filtered to a historical round." }, "includeMatches": { "title": "Include Matches", "type": "boolean", "description": "Whether to return match rows with teams, dates, scores, status, winner, and round. Disable this only when you need league tables without fixtures. Recommended: keep enabled for most workflows because match rows are the primary result feed.", "default": true }, "includeStandings": { "title": "Include Standings", "type": "boolean", "description": "Whether to return current season standings rows for league competitions. The actor ignores standings for DFB-Pokal because cup competitions do not have a league table, and the Round input does not rewind tables to a historical matchday. Disable this to reduce output size when you only need fixtures and results.", "default": true }, "maxMatches": { "title": "Max Matches Per Competition", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum match rows to return for each selected competition after round filtering. Higher values give a fuller season dataset but produce more rows and take longer. Use 10 to 20 for testing or matchday updates, and 500 for full league seasons and cup runs.", "default": 20 }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "ID of an existing Apify dataset to append results to, in addition to the default run dataset. Leave blank to use only the default run dataset. Use this when chaining scheduled football updates into a long-lived database or dashboard dataset." }, "runId": { "title": "Run ID (optional)", "type": "string", "description": "ID of an existing Apify actor run or workflow step to associate with output rows. The actor copies this value into each row when provided, which helps connect German football results to pipeline runs. Leave blank for standalone runs." } } }, "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 } } } } } } } } } }