{ "openapi": "3.0.1", "info": { "title": "France Football Results & Tables", "description": "Extracts France football matches, scores, 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": "cBuDS9BQmLtrlAkey" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trovevault~france-football-results-tables/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trovevault-france-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~france-football-results-tables/runs": { "post": { "operationId": "runs-sync-trovevault-france-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~france-football-results-tables/run-sync": { "post": { "operationId": "run-sync-trovevault-france-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": "France football competitions to retrieve. The actor fetches season fixtures and results, then calculates standings from completed matches. Select one league for a compact run or several competitions to compare supported domestic leagues in one run. Only supported competitions from the dropdown are processed.", "items": { "type": "string", "enum": [ "ligue-1", "ligue-2" ], "enumTitles": [ "Ligue 1", "Ligue 2" ] } }, "season": { "title": "Season Start Year", "minimum": 2014, "maximum": 2030, "type": "integer", "description": "Season start year to retrieve. France football seasons use the first year of the season, so 2025 means the 2025/2026 season for supported competitions. Use a recent year such as 2024 or 2025 for the most complete data. The free JSON dataset coverage for this actor starts at 2014/2015. Older API inputs are rejected by the input schema or handled gracefully as no-result runs when no source file exists.", "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, for example 1 for opening matchday. Leave blank to retrieve all matches in the selected season. Standings are calculated from all completed matches available for the season, not from the selected round only." }, "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 matchday feeds and dashboards.", "default": true }, "includeStandings": { "title": "Include Standings", "type": "boolean", "description": "Whether to calculate and return standings rows for selected league competitions. The table is calculated from completed full-time results in the selected season. Disable this to reduce output size when you only need fixtures and scores.", "default": true }, "maxMatches": { "title": "Max Matches Per Competition", "minimum": 1, "maximum": 600, "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 600 for full league seasons.", "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 datasets. Leave blank to use only the default Matches and Standings outputs. Use this when chaining scheduled France football updates into a long-lived 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 France 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 } } } } } } } } } }