{
  "openapi": "3.0.1",
  "info": {
    "title": "Sports Betting Odds Scraper — Tennis, Soccer + 5K Props",
    "description": "Scrape live and pre-match betting odds from Pinnacle and Bovada — sharp baseline plus the largest US offshore book, keyless, no login. Moneyline, spreads, totals, 5K+ specials and props markets, de-vigged fair odds, line movement and best-price flags across books. Tennis, soccer, NFL, NBA and more.",
    "version": "0.3",
    "x-build-id": "4f8uge8PHgP97taRN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zhorex~sports-odds-aggregator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zhorex-sports-odds-aggregator",
        "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/zhorex~sports-odds-aggregator/runs": {
      "post": {
        "operationId": "runs-sync-zhorex-sports-odds-aggregator",
        "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/zhorex~sports-odds-aggregator/run-sync": {
      "post": {
        "operationId": "run-sync-zhorex-sports-odds-aggregator",
        "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": {
          "books": {
            "title": "Sportsbooks",
            "type": "array",
            "description": "Which sportsbooks to pull odds from. The form is prefilled with <b>Bovada</b>: the largest US offshore book, keyless JSON with no login, cookie or signature, and it answers from Apify's datacenter range in 1-13 s for every sport (measured 2026-09-10). <b>Pinnacle</b> is the canonical sharp-line book and the reference price for +EV work — add it alongside Bovada for cross-book best-price comparison and no-vig fair odds. One caveat measured 2026-09-10: Pinnacle's soccer feed is a 50 MB document that takes 93-233 s through a datacenter proxy, so pair Pinnacle with a leagueFilter or a lighter sport rather than asking it for all of soccer. <b>Kambi</b> covers the Unibet/Paf/Betsson family from one public feed and keeps the run alive if any single book closes its doors. <b>Bet365</b> is temporarily UNDER REPAIR (their public mobile-web endpoints changed; selecting it right now returns 0 events). US books (DraftKings / FanDuel / BetMGM) are intentionally out of scope: they need US residential proxy. API calls and saved Tasks that omit this field keep the long-standing default, Pinnacle, so existing integrations are unchanged.",
            "items": {
              "type": "string",
              "enum": [
                "pinnacle",
                "bet365",
                "kambi",
                "bovada"
              ]
            },
            "default": [
              "pinnacle"
            ]
          },
          "sports": {
            "title": "Sports",
            "type": "array",
            "description": "Which sports to query. These are top-level categories, not league names — the leagues inside each one rotate with the calendar, so pick the category and read the `league` field on the rows. Measured on Bovada 2026-09-10 with the default cap of 15 events: american_football_intl 15 events / 90 rows, all NFL (College Football and CFL sit behind them in the same feed); ice_hockey 15 / 90, all NHL; soccer 15 / 105 (Premier League first, 1,477 pre-match fixtures available); basketball 15 / 74 (NBA, Euroleague, WNBA); tennis 15 / 66 but the window is thin between tournaments; baseball only 5 MLB fixtures and a same-day window. The form is prefilled with NFL + NHL, the pair that is deep, US-facing and priced end-to-end right now; API calls and saved Tasks that omit this field keep the long-standing default, soccer + tennis. On Pinnacle the shelf is different — soccer is by far the deepest (1,266 fixtures) and tennis runs year-round, but see the note on Pinnacle's soccer payload size under Sportsbooks. Empty selections waste a run budget — if a sport comes back with nothing, the run status says so explicitly.",
            "items": {
              "type": "string",
              "enum": [
                "soccer",
                "tennis",
                "basketball",
                "ice_hockey",
                "mma",
                "baseball",
                "american_football_intl",
                "rugby_union",
                "rugby_league",
                "cricket",
                "esports"
              ]
            },
            "default": [
              "soccer",
              "tennis"
            ]
          },
          "leagueFilter": {
            "title": "League filter (optional)",
            "type": "array",
            "description": "Optional league codes / display-name fragments to whitelist (e.g. 'EPL', 'UEFA', 'ATP', 'NBA'). Empty = all leagues for the chosen sports. Case-insensitive substring match against the book's league label.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "marketTypes": {
            "title": "Market types",
            "type": "array",
            "description": "Which betting markets to extract per event. 'h2h' (moneyline) is the canonical sharp market. 'spreads' (handicap) and 'totals' (over/under) drive most EV-modelling pipelines. 'specials' enables Pinnacle's futures / yes-no / first-team-to-score / exact-totals / team-props markets (premium $0.05 tier — there are 5,000+ specials per major sport, so use maxEventsPerSport to control volume). 'player_props' is the Bet365-only player-prop tier (premium $0.05 — currently returns empty while Bet365 mode is under repair).",
            "items": {
              "type": "string",
              "enum": [
                "h2h",
                "spreads",
                "totals",
                "first_half_h2h",
                "first_half_spreads",
                "first_half_totals",
                "specials",
                "player_props"
              ]
            },
            "default": [
              "h2h",
              "spreads",
              "totals"
            ]
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "pre_match_only",
              "live_only",
              "pre_match_and_live"
            ],
            "type": "string",
            "description": "'pre_match_only' (default) returns scheduled fixtures and is the cheapest, most-common workflow (5-15 min cadence). 'live_only' returns in-play markets — premium pricing tier; use with scheduled runs at ≤5 min cadence. 'pre_match_and_live' covers both, useful for arb finders that want to compare scheduled vs in-play lines.",
            "default": "pre_match_only"
          },
          "priceFormat": {
            "title": "Price format",
            "enum": [
              "decimal",
              "american",
              "fractional"
            ],
            "type": "string",
            "description": "Output price format. 'decimal' (1.91) is the sharp / EU standard and is most convenient for implied-probability math; the actor ALWAYS computes the other two as well so all three fields are always populated.",
            "default": "decimal"
          },
          "maxEventsPerSport": {
            "title": "Max events per sport (hard cap)",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Safety cap on number of events extracted per (book, sport) pair. Multiply by ~5-10 market-outcomes per event to estimate snapshot volume per run. The form is prefilled with 15 on purpose: at 6 rows/event and $0.01/row, the two prefilled sports cost about $1.85 per run, so a first run fits inside Apify's $5 free credit with room to try a second. API calls and saved Tasks that omit this field keep the long-standing default of 50 — across two deep sports that is ~$5.4 per run.",
            "default": 50
          },
          "includeAlternateLines": {
            "title": "Include alternate lines (more rows, more cost)",
            "type": "boolean",
            "description": "Pinnacle only. Off by default. When on, the whole alternate ladder is returned — every extra handicap and total, not just the primary line (e.g. spread -1.5 / -1.0 / -0.5 alongside the main one). It costs no extra request, but it multiplies BILLED rows, and HOW MUCH depends on how many events you take. Measured 2026-08-07: across a full pre-match sweep it is about ×1.7 (×1.66 soccer, ×2.59 tennis, ×3.24 basketball, ×1.58 baseball, ×1.00 ice hockey), but with maxEventsPerSport=10 the same run went 42 → 354 rows, i.e. ×8.4 — the fewer events you take, the larger the share that is ladder. Check your first run's row count before scaling up. Rows carry `isAlternate` so you can filter, and `marketKey` so two rungs at the same line stay distinguishable.",
            "default": false
          },
          "includeBestPriceFlag": {
            "title": "Flag best price across books",
            "type": "boolean",
            "description": "When ≥2 books are selected, mark exactly one outcome per (event, market, outcome) as the best price across the chosen books. This is the foundation for any 2-way arbitrage workflow.",
            "default": true
          },
          "deduplicationWindowSeconds": {
            "title": "Dedup window (seconds)",
            "minimum": 0,
            "maximum": 3600,
            "type": "integer",
            "description": "If a price hasn't changed within this many seconds, suppress the duplicate snapshot — keeps PPE cost down on cron runs where most lines are stable. Set to 0 to disable and emit every snapshot.",
            "default": 30
          },
          "cookieStrings": {
            "title": "Optional per-book cookie strings",
            "type": "object",
            "description": "Optional. Object keyed by book name ({ 'bet365': '...', 'pinnacle': '...' }) with raw cookie headers from your browser DevTools to raise per-IP rate limits on heavy runs. NOT required for typical workloads — both books work anonymously."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Leave this as it comes. The default (Apify Proxy, automatic selection) uses datacenter IPs, which is the right cost/quality point for both books — residential burns roughly 20x the proxy cost with no quality lift. Do NOT set apifyProxyGroups to \"DATACENTER\": that is not a real Apify group name and the run will refuse to start. If the run log shows repeated \"unhealthy (code=403)\" lines and a sport comes back empty, the exit range is being blocked by the book — switch apifyProxyGroups to [\"RESIDENTIAL\"] for that run.",
            "default": {
              "useApifyProxy": true
            }
          },
          "includeFairOdds": {
            "title": "Add vig-free fair odds (premium add-on)",
            "type": "boolean",
            "description": "Compute the vig-free fair probability + fair decimal odds (no-vig / CLV benchmark) for every market line and add them to each row (noVigFairPrice, noVigProb, overround) — the standard baseline for spotting +EV prices at softer books and for model calibration. Opt-in premium: from 8 Aug 2026 this charges the fair-odds-enrichment event ($0.05) per enriched snapshot, on top of the base snapshot price. Leave off for raw odds only.",
            "default": false
          },
          "includeLineMovement": {
            "title": "Add line movement (free)",
            "type": "boolean",
            "description": "Adds movement fields to every snapshot by comparing the price to the last one this account's runs saw for the same market-outcome: previousPrice, priceChange, priceChangePct, impliedProbChange, moveDirection (shortened / drifted / unchanged), secondsSincePreviousPrice, plus firstSeenPrice and moveSinceFirstSeen for movement since the first observation. Free — it reuses the state the dedup window already keeps, so there is no extra request and no extra charge. Fields appear from your SECOND run of a market onward (the first run has nothing to compare to).",
            "default": 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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}