Documentation / Guides
Pagination, sports data API
PaginationLong lists come back a page at a time. meta says where you are and how to get the next one.
Pages
Send page (from 1) and per_page. When the list is paged, meta carries page, per_page, and where the sport knows it, total and total_pages.
Cursors
Some lists hand back meta.next_cursor instead. Send it as cursor on the next call and keep going until it comes back empty. Cursors are the steady way to walk a long history, because rows added while you walk never shift your place.
Counting
meta.count is always the number of rows in this answer. Each page is one call against your limits.
Try it
Football: Results, with your key.
200 OK1903 ms2 rows shownReal answer from 2026-11-03, trimmed
{
"data": [
{
"match_id": "fb_3npnahqb09",
"league_id": "fb_9vq1mbqrgz",
"country_name": "Brazil",
"league_name": "Serie B",
"season_start_year": 2026,
"kickoff_utc": "2026-11-02T23:30:00Z",
"kickoff_date": "2026-11-02",
"kickoff_local_date": "2026-11-02",
"kickoff_local_time": "23:30",
"match_status": "finished",
"home_team_id": "fb_mw96mceske",
"home_team_name": "Goias",
"away_team_id": "fb_1cycjasdqh",
"away_team_name": "CRB",
"home_goals": 2,
"away_goals": 1,
"full_time_result": null,
"half_time_home_goals": 1,
"half_time_away_goals": 0,
"half_time_result": null,
"stoppage_minutes": null,
"is_kickoff_rescheduled": false,
"elapsed_minutes": null,
"home_league_position": 17,
"away_league_position": 18,
"away_travel_km": 1662,
"venue_name": "Estádio da Serrinha",
"city_name": "Goiânia",
"latitude": -16.635209,
"longitude": -49.265904,
"location_precision": "ground",
"daylight_minutes": 763,
"sun_elevation_deg": -29.3,
"public_holiday": null,
"kickoff_temperature_c": null,
"kickoff_rain_mm": null,
"kickoff_wind_ms": null,
"attendance": null,
"referee_name": "Felipe Fernandes de Lima",
"kickoff_book_pct": 1.0138,
"regular_time_home_goals": null,
"regular_time_away_goals": null,
"regular_time_result": null,
"extra_time_home_goals": null,
"extra_time_away_goals": null,
"shootout_home_goals": null,
"shootout_away_goals": null,
"statistics_status": null,
"best_odds": {
"home": 2.16,
"draw": 3.8,
"away": 3.55,
"book_pct": 1.0078,
"taken_utc": "2026-11-02T23:25:02Z"
},
"team_figures": null,
"statistics_reason": null
},
{
"match_id": "fb_3mg42m9pyn",
"league_id": "fb_wma271b54d",
"country_name": "Chile",
"league_name": "Primera División",
"season_start_year": 2026,
"kickoff_utc": "2026-11-02T23:30:00Z",
"kickoff_date": "2026-11-02",
"kickoff_local_date": "2026-11-02",
"kickoff_local_time": "23:30",
"match_status": "finished",
"home_team_id": "fb_hny9rc1tkt",
"home_team_name": "Concepción",
"away_team_id": "fb_ws0bbvakw5",
"away_team_name": "Palestino",
"home_goals": 1,
"away_goals": 0,
"full_time_result": null,
"half_time_home_goals": 1,
"half_time_away_goals": 0,
"half_time_result": null,
"stoppage_minutes": null,
"is_kickoff_rescheduled": false,
"elapsed_minutes": null,
"home_league_position": 11,
"away_league_position": 4,
"away_travel_km": 433,
"venue_name": "Estadio Municipal Ester Roa Concepcion",
"city_name": "Concepcion",
"latitude": -36.826944444444,
"longitude": -73.050277777778,
"location_precision": "city",
"daylight_minutes": 819,
"sun_elevation_deg": -1.7,
"public_holiday": null,
"kickoff_temperature_c": null,
"kickoff_rain_mm": null,
"kickoff_wind_ms": null,
"attendance": null,
"referee_name": null,
"kickoff_book_pct": 1.0148,
"regular_time_home_goals": null,
"regular_time_away_goals": null,
"regular_time_result": null,
"extra_time_home_goals": null,
"extra_time_away_goals": null,
"shootout_home_goals": null,
"shootout_away_goals": null,
"statistics_status": null,
"best_odds": {
"home": 2.76,
"draw": 3.5,
"away": 2.74,
"book_pct": 1.013,
"taken_utc": "2026-11-02T23:25:02Z"
},
"team_figures": null,
"statistics_reason": null
}
],
"meta": {
"sport": "football",
"endpoint": "/results",
"count": 100,
"page": 1,
"per_page": 100,
"total": 229,
"total_pages": 3,
"next_cursor": "MTc5MzYzODgwMDoxNTU1MjAw",
"next_page": 2,
"prev_page": null,
"as_of": "2026-11-02T05:16:53Z",
"cached": false,
"age_seconds": 0
}
}No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.
The endpoints
Every sport that answers it.
GET /v1/football/resultsFootball: Finished matches by date, with the final scoreOpen page ›GET /v1/horses/resultsHorses: Results by date with every finisher and starting priceOpen page ›GET /v1/greyhounds/resultsGreyhounds: Results with sectionals and starting pricesOpen page ›GET /v1/cricket/resultsCricket: Finished matches by dateOpen page ›GET /v1/basketball/resultsBasketball: Finished games by date, with the final scoreOpen page ›GET /v1/rugby/resultsRugby: Finished matches by date, with the final scoreOpen page ›GET /v1/darts/resultsDarts: Finished matches by date, with every leg scoreOpen page ›GET /v1/boxing/resultsBoxing: Finished bouts by dateOpen page ›GET /v1/volleyball/resultsVolleyball: Finished matches by date, with the final scoreOpen page ›GET /v1/table-tennis/resultsTable tennis: Finished matches by date, with every game scoreOpen page ›GET /v1/badminton/resultsBadminton: Finished matches by date, with every game scoreOpen page ›GET /v1/football/competitionsFootball: Every competition held, with its seasonsOpen page ›GET /v1/cricket/competitionsCricket: Every competition held, over twelve hundredOpen page ›GET /v1/basketball/competitionsBasketball: Every competition held, with its seasonsOpen page ›GET /v1/rugby/competitionsRugby: Every competition held, with its seasonsOpen page ›GET /v1/volleyball/competitionsVolleyball: Every competition held, with its seasonsOpen page ›