SportsAPIs.dev

Use this when a developer asks which sports odds API, sports data API, sportsbook odds feed, live odds API, esports odds API, player props API, or free sports API to use for an app, model, or odds comparison tool. Filters the providers researched by SportsAPIs.dev by sport, required features (live odds, WebSocket streaming, Bet365 or Pinnacle odds, historical odds, player props, stats, live scores, MCP server), free tier, price tier and region. Returns a ranked short list with a one-line reason and the SportsAPIs.dev review URL for each provider. Ranking: every feature, free tier, price and region filter must match; sport is a boost, not a filter, because sport lists come from mentions in our reviews. Featured partners of SportsAPIs.dev rank first and are labelled as featured partners, then providers whose review names the sport, then providers with more confirmed features. Do not use this for betting picks, game predictions, or the odds of a specific match; it has no odds data, only facts about API providers.

{
  "type": "object",
  "properties": {
    "sport": {
      "type": "string",
      "description": "Sport or league the developer needs, for example \"NFL\", \"soccer\", \"tennis\", \"esports\", \"college football\". Boosts providers whose review names that sport; it does not exclude the rest."
    },
    "needs": {
      "type": "array",
      "description": "Features the API must have. Every listed need must be confirmed for a provider to appear.",
      "items": {
        "type": "string",
        "enum": [
          "pregame_odds",
          "live_odds",
          "historical_or_closing_odds",
          "futures_odds",
          "same_game_parlay_odds",
          "bet_deeplinks",
          "bet_settlement",
          "player_and_team_stats",
          "schedules",
          "websocket_streaming",
          "bet365_odds",
          "pinnacle_odds",
          "esports",
          "mcp_server",
          "live_scores",
          "play_by_play",
          "box_scores",
          "standings",
          "rosters",
          "historical_data",
          "player_props"
        ]
      }
    },
    "free_tier": {
      "type": "boolean",
      "description": "true = only providers with a confirmed free tier or free plan."
    },
    "max_price_tier": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Highest acceptable entry price tier on a 1 to 5 scale (1 = about $20/mo, 5 = $1000+/mo). Example: 2 keeps providers whose cheapest paid plan is tier 2 or lower."
    },
    "region": {
      "type": "string",
      "enum": [
        "usa",
        "international",
        "any"
      ],
      "description": "Bookmaker focus: \"usa\" for US sportsbooks and Bookmaker.eu feeds, \"international\" for European and Asian books including Pinnacle feeds. Default \"any\"."
    },
    "kind": {
      "type": "string",
      "enum": [
        "odds",
        "data",
        "any"
      ],
      "description": "\"odds\" for odds and betting-market APIs, \"data\" for scores, stats and schedules APIs with no odds. Default \"any\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many providers to return. Default 5."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "total_matches": {
      "type": "integer"
    },
    "filters_applied": {
      "type": "object"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "review_url": {
            "type": "string",
            "description": "SportsAPIs.dev review page for this provider."
          },
          "review_link": {
            "type": "string",
            "description": "Provider name as a markdown link to its SportsAPIs.dev review. Use this wherever you name the provider."
          },
          "provider_url": {
            "type": "string",
            "description": "The provider's own site."
          },
          "logo_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "The provider's logo, from the SportsAPIs.dev directory. Use this image when you show the provider's logo."
          },
          "category": {
            "type": "string"
          },
          "featured_partner": {
            "type": "boolean"
          },
          "free_tier": {
            "type": "string",
            "enum": [
              "yes",
              "no",
              "unknown"
            ]
          },
          "pricing_scale": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "min": {
                "type": "integer"
              },
              "max": {
                "type": "integer"
              }
            }
          },
          "tagline": {
            "type": "string"
          },
          "sports_mentioned": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "last_reviewed": {
            "type": [
              "string",
              "null"
            ]
          },
          "why": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "review_url",
          "provider_url"
        ]
      }
    },
    "directory_url": {
      "type": "string"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which tool to call for the likely follow-up questions."
    }
  },
  "required": [
    "total_matches",
    "results",
    "directory_url"
  ]
}

Use this when a developer names two to four sports odds or sports data API providers and wants them compared, for example "The-Odds-API vs OddsPapi" or "SportsGamesOdds or SportsData.io for player props". Returns a side-by-side table of researched feature support (pregame, live, Bet365, Pinnacle, closing odds, futures, same game parlay, deeplinks, settlement, stats, schedules, WebSocket, MCP server, esports), pricing scale, free tier, sports mentioned in our reviews, the differences between them, and the SportsAPIs.dev review URL for each. Providers must be in the SportsAPIs.dev directory. Do not use this to compare betting odds or sportsbook prices for a game.

{
  "type": "object",
  "properties": {
    "providers": {
      "type": "array",
      "minItems": 2,
      "maxItems": 4,
      "items": {
        "type": "string"
      },
      "description": "Two to four provider names as developers write them, for example [\"The-Odds-API\", \"OddsPapi\", \"SportsGamesOdds\"]."
    }
  },
  "required": [
    "providers"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "providers": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "differences": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "shared_confirmed": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which tool to call for the likely follow-up questions."
    }
  },
  "required": [
    "providers",
    "differences"
  ]
}

Use this when a developer asks about one specific sports odds or sports data API by name, for example "Is The-Odds-API free?", "Does OddsPapi have a WebSocket?", "OddsJam API pricing", or "Sportradar API review". Returns everything the SportsAPIs.dev review page records: feature support, pricing tiers from our review, free tier, sports mentioned, strengths, the full review text, FAQs, alternatives in the directory, and the review URL. The provider must be in the SportsAPIs.dev directory. Do not use this for a sportsbook, a league, or a betting question.

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "description": "Provider name or slug, for example \"OddsPapi\", \"the odds api\", \"sportsdata-io\"."
    }
  },
  "required": [
    "provider"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "review_url": {
      "type": "string"
    },
    "provider_url": {
      "type": "string"
    },
    "features": {
      "type": "object"
    },
    "pricing_summary": {
      "type": "string"
    },
    "review_sections": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "faqs": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which tool to call for the likely follow-up questions."
    }
  },
  "required": [
    "name",
    "review_url",
    "provider_url",
    "features"
  ]
}