API v4 Documentation

Endpoints Code Lookup

← All endpoints

pointspread

game EuroBB, AmerBB, AsiaBB, MBB, NBA, WNBA, KBO, MiLB, MLB, NPB, NHL

A query to this endpoint without a range parameter will return recent Betsson point spread data. Passing a date or date range will return spreads for those dates if data is available. Please note that not every game has point spread data.

Please note that this endpoint can be used synonymously as spread.

MLB Recent Point Spreads
https://api4.natst.at/xxxx-xxxxxx/pointspread/mlb/ Download sample

Parameters

Range

NameRequiredTypeDescription
dataformat optional range Controls the data format by which query results are returned. Acceptable values are xml, json or php. The default value is json. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nba/xml
season optional range A valid season code (the year when a particular season completes) in YYYY format. A list of available values can be retrieved from the seasons endpoint. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nba/2025
date optional range A date in YYYY-MM-DD format. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nba/2025-03-23
daterange optional range Two dates in YYYY-MM-DD format. Any additional dates beyond two will be ignored. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nba/2025-03-23,2025-03-30
teamcode optional range A two to eight-character code for a team. A list of available values can be retrieved from the /teamcodes endpoint or the lookup below. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nba/XXX
leaguecode optional range A two to eight-character code for a league. A list of available values can be retrieved from the /leaguecodes endpoint or the lookup below. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/eurobb/XXX
playercode optional range A numeric code for a player. A list of available values can be retrieved from the /players endpoint. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nba/XXX
search optional range If a comma-separated value is none of the above, the API will assume it is a search term. The system will only accept the first entry in a string as a search term. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nba/XXX

Query

NameRequiredTypeDescription
key required path A valid API key in xxxx-xxxxxx format. This must be the first path parameter. Example: https://api4.natst.at/xxxx-xxxxxx/...

Path

NameRequiredTypeDescription
endpoint required path The API endpoint to query. This must be the second path parameter. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/...
level required path One of 30 NatStat data services to query. A full list can be found in the documentation. This must be the third path parameter. Example: https://api4.natst.at/xxxx-xxxxxx/pointspread/nhl/...