International football does not behave like a club competition. It arrives in concentrated windows a few times a year, the fixture list spans every confederation at once, and the range of quality inside a single matchday is far wider than any domestic league produces. Our international soccer odds API covers that entire picture through one league identifier — national team fixtures, confederation qualifiers, major tournaments, Nations League matches and friendlies.
Covering more than international football? The soccer odds API spans 19 competitions, including the Premier League, the Champions League and MLS.
One leagueID, many competitions
This is the structural point to understand before you integrate, because international football is modelled differently from the club leagues.
Everything national-team is carried under a single leagueID of INTERNATIONAL_SOCCER, rather than split into separate identifiers per tournament. One request returns whatever national team football is on — World Cup qualifiers from several confederations, a Nations League matchday, or a summer tournament — without you having to enumerate competitions or add new league codes when a new cycle begins.
The practical consequence is that a single query can return fixtures of wildly different profiles side by side: a marquee tie between two top-ranked sides and a qualifier between nations that a sportsbook prices thinly. Build for that spread rather than assuming uniform market depth.
International Soccer Odds API Features
Available international betting markets include:
- Match winner (1X2) and 2-way moneyline
- Asian handicaps and European handicaps
- Totals (over/under goals), team totals and both teams to score
- Alternative lines and totals
- Goalscorer markets — anytime, first and last
- Player props — shots, shots on goal, assists, tackles, passes, cards
- Goalkeeper props — saves and goals against
- Card and corner markets, plus first and second half variants
Market depth is greatest on tournament fixtures and qualifiers involving well-covered nations, where the full prop catalogue is posted. Friendlies and matches between lower-ranked sides reliably carry the core markets — 1X2, handicaps and totals — with props where individual sportsbooks price them.
All data is available pre-match and live. Odds refresh sub-minute on the Pro plan, with Rookie and the free Amateur tier updating on a longer interval — see pricing for the frequency on each tier.
Knockout ties: regulation vs full match
Tournament knockout matches cannot end level, which makes the period distinction more important here than in most competitions.
Match lines sit on the reg period — 90 minutes plus stoppage time, with the draw as its own outcome, which is why the headline market is a 3-way moneyline. The game period covers the full match including extra time (ot) and a penalty shootout (so).
In the group stage the two are effectively the same, because matches end after 90 minutes. In the knockout rounds they diverge, and a shootout is a routine outcome rather than an edge case. Requesting reg when you meant game will make your settlement logic disagree with the sportsbook on precisely the matches that matter most. Player props and prop-style markets sit on game.
International Soccer Player Props
Query goalscorer and player performance markets across the fixture list — anytime goalscorer odds, shots on goal totals, assist props, card markets and goalkeeper saves.
Filter by player ID, stat type or bookmaker to return only the props relevant to your platform. Squad selection is a larger factor here than in club football: managers experiment freely in friendlies and rest players between qualifiers, so goalscorer markets move sharply on team news. See the player prop odds API for the full market list across every sport we cover.
International Soccer Odds API with Results
Our API delivers international odds and match results together in a single response, with no secondary calls and no data stitching. Each response includes:
- Live, upcoming and completed international fixtures
- Home and away team data
- Player and match statistics
- Full odds coverage: 1X2, handicaps, totals, goalscorer and player props, alternative lines
- Final scores and settlement data, including extra time and shootouts
https://api.sportsgameodds.com/v2/eventsRequest Parameters
leagueID=NFLOnly NBA games
oddsAvailable=trueOnly games with available odds
includeAltLines=falseDon't return alt-lines
limit=1Number of games to return
Quick Start: Your First International Soccer Odds API Call
Fetching international odds takes a single HTTP request. Here's the quickest way to get upcoming national team fixtures with full odds:
https://api.sportsgameodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&leagueID=INTERNATIONAL_SOCCER&limit=10
This returns all available markets including 1X2, handicaps, totals and player props across the next 10 international fixtures.
To target a specific market, use the oddIDs parameter. This returns the total corners line for every match:
https://api.sportsgameodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&leagueID=INTERNATIONAL_SOCCER&oddIDs=cornerKicks-all-game-ou-over,cornerKicks-all-game-ou-under
International windows pause the domestic calendar, so during them this is often the only soccer on. Outside those windows, query at sport level to pick up whatever is playing:
https://api.sportsgameodds.com/v2/events?apiKey=YOUR_API_KEY&sportID=SOCCER&oddsAvailable=true&limit=25
OddIDs follow the format {statID}-{statEntityID}-{periodID}-{betTypeID}-{sideID}. Goals are carried under the points statID, since points is the score stat for every sport.
Tips to keep your queries fast and efficient:
- Use
regfor match lines andgamefor props — see the knockout section above for why - Check whether a prop market is present rather than assuming it, since depth varies widely across the fixture list
- Use
includeOpposingOdds=trueso you only need to specify one side of a market and automatically receive both - Note: 1 object = 1 event regardless of how many markets are returned, so a 20-fixture qualifying matchday = 20 objects
What an international soccer response looks like
Every match returns an odds object keyed by oddID. Here's a trimmed total corners market, with the bookmaker list cut to two books:
{
"eventID": "...",
"leagueID": "INTERNATIONAL_SOCCER",
"odds": {
"cornerKicks-all-game-ou-over": {
"oddID": "cornerKicks-all-game-ou-over",
"opposingOddID": "cornerKicks-all-game-ou-under",
"marketName": "Total Corner Kicks Over/Under (Full Match)",
"statID": "cornerKicks",
"statEntityID": "all",
"periodID": "game",
"betTypeID": "ou",
"sideID": "over",
"fairOdds": "-104",
"fairOverUnder": "9.5",
"bookOdds": "-110",
"bookOverUnder": "9.5",
"byBookmaker": {
"bet365": { "odds": "-110", "overUnder": "9.5", "available": true },
"pinnacle": { "odds": "-102", "overUnder": "10", "available": true }
}
}
}
}
A statEntityID of all means the market covers both teams combined — swap it for home or away to get one nation's corner count instead. Corner and card markets sit on the game period rather than reg, which is why the market name is suffixed (Full Match). Note that Pinnacle is on a whole number (10) while bet365 is on a half (9.5): a whole-number total can push, a half cannot, so those two lines are not interchangeable even when the prices look close.
International Soccer Odds API Technical Specifications
API Architecture
- REST API — standard HTTP endpoints returning clean JSON responses
- WebSocket feeds — real-time push updates with no polling required
- Rate limits — scalable plans matched to your usage volume
- Authentication — secure API key access
Data Update Speed
- Odds updates — sub-minute refresh on Pro; longer intervals on Rookie and Amateur
- Live scores — updated in real time, including stoppage time, extra time and shootouts
Developer Resources
- Interactive documentation — live examples and copy-paste snippets
- SDKs & libraries — JavaScript/TypeScript, Python, Ruby, Go and Java
- Postman collection — pre-built requests ready to run
- Dedicated technical support across paid plans
Use Cases
Odds Comparison Platforms — Display international 1X2 prices, handicaps and totals from 85+ bookmakers in one place across a qualifying matchday spanning several confederations.
Arbitrage & +EV Tools — The quality spread within a single matchday is wider than any domestic league produces, and books model lower-ranked nations very differently from one another. See also positive EV betting.
Goalscorer & Player Prop Tools — Surface anytime goalscorer odds, shots on goal and assist props, updating as squad selections are confirmed.
Sportsbook & Fantasy Apps — International windows pause the club calendar, so national team fixtures are what keeps a soccer product active during them.
Sports Analytics & Research — Study how markets price nations with sparse recent data, a modelling problem that barely exists in club football.
International Soccer API Documentation
Our interactive documentation covers everything you need to integrate international odds into your application:
- Full endpoint reference with parameters and response schemas
- Live request and response examples
- Code snippets in Python, JavaScript and more
- Authentication setup and API key management
- Webhook configuration
- Error handling and troubleshooting
For more on what we carry across national team football, see our guides to international soccer coverage and World Cup 2026 coverage, or the API documentation for a step-by-step walkthrough.