{
  "openapi": "3.0.1",
  "info": {
    "title": "OddsPortal Scraper - Historical Odds, Opening & Closing Lines",
    "description": "Past results and odds from any OddsPortal tournament: one row per match with the final score, the winning outcome, average and highest closing odds, and every bookmaker's opening and closing odds with timestamps. Football, basketball, tennis and more. Pick up to 5 countries to see more bookmakers.",
    "version": "0.1",
    "x-build-id": "QmwC7q031qCFFjgL9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/neverempty~oddsportal-historical-odds-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-neverempty-oddsportal-historical-odds-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/neverempty~oddsportal-historical-odds-scraper/runs": {
      "post": {
        "operationId": "runs-sync-neverempty-oddsportal-historical-odds-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/neverempty~oddsportal-historical-odds-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-neverempty-oddsportal-historical-odds-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": {
          "tournamentUrls": {
            "title": "Tournament results pages",
            "type": "array",
            "description": "OddsPortal tournament addresses, one per line. Open the tournament on oddsportal.com, pick the season, open its Results tab and paste the address, for example https://www.oddsportal.com/football/england/premier-league-2023-2024/results/ or https://www.oddsportal.com/basketball/usa/nba-2023-2024/results/. The address without /results/ works too. The current season is https://www.oddsportal.com/football/england/premier-league/results/.",
            "items": {
              "type": "string"
            }
          },
          "maxMatches": {
            "title": "Maximum matches",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "The most matches to return in this run (each returned match is one charged row). With several tournaments the maximum is shared fairly between them. Matches come newest first, as the site lists them. A full football league season is about 380 matches; an NBA season is about 1,400.",
            "default": 100
          },
          "includeBookmakerOdds": {
            "title": "Each bookmaker's opening and closing odds",
            "type": "boolean",
            "description": "On: every match row also lists each bookmaker with its opening odds, closing odds and the times they were set. Off: only the site's average and highest closing odds, which is faster.",
            "default": true
          },
          "bookmakerRegions": {
            "title": "Countries to see bookmakers from",
            "type": "array",
            "description": "OddsPortal shows the bookmakers available in the visitor's country, so the run looks from each country you pick and merges the lists. Each row says which countries each bookmaker was seen from. Measured on one Premier League match on 2026-10-21: United Kingdom 10 bookmakers, Italy 11, Ireland 9, Austria 9, Spain 7, Poland 6, Germany 5, Sweden 5, Czechia 4, Canada 4, Kenya 4, France 3, Nigeria 2, Brazil 1, United States 1. Up to 5 countries; each extra country adds one request per match.",
            "items": {
              "type": "string",
              "enum": [
                "GB",
                "IE",
                "IT",
                "ES",
                "DE",
                "PL",
                "SE",
                "FR",
                "CZ",
                "AT",
                "CA",
                "US",
                "BR",
                "NG",
                "KE"
              ],
              "enumTitles": [
                "United Kingdom",
                "Ireland",
                "Italy",
                "Spain",
                "Germany",
                "Poland",
                "Sweden",
                "France",
                "Czechia",
                "Austria",
                "Canada",
                "United States",
                "Brazil",
                "Nigeria",
                "Kenya"
              ]
            },
            "default": [
              "GB"
            ]
          },
          "includeUnplayedMatches": {
            "title": "Include matches without a final score",
            "type": "boolean",
            "description": "Off (the default): only matches that have a result. On: also postponed, cancelled or not-yet-played matches the results page lists.",
            "default": false
          },
          "includeMatchesWithoutOdds": {
            "title": "Include matches without odds",
            "type": "boolean",
            "description": "Off (the default): matches the site has no odds for are left out. On: they are returned with the odds fields empty.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}