Search
/
View as MarkdownTry in Playground →
A single search over teams (individual competitors included), players, managers, referees, leagues, fixtures, venues, racing series and races; each hit’s type names the endpoint family its id is valid for. Those families are /v2/teams, /v2/players, /v2/managers, /v2/referees, /v2/leagues, /v2/fixtures, /v2/series and /v2/races (venue ids are covered in the note). Player hits include the player’s current team; fixture hits include the teams, league, start time and status; venue hits include city, country and capacity.
Parameters
qqueryrequired
text to search for: 2–100 characters once trimmed and free of control characters, otherwise a 400 names q as the problem
typequery
limits hits to one type — team | player | league | manager | referee | series | race | fixture | venue — at 20 per page; leave it out for the single-page mixed list
pagequery
page number from 0 to 50 (defaults to 0); a page above 0 needs a type other than series
Response
- data
SearchResult[]- meta
- query, type, page, count, hasNextPage
- errors
- 400
bad_request— q is absent, type is not recognised, page is not within 0–50, or page is above 0 while type is missing or set to series
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/search?q=…"{ "data": [ { "type": "player", "id": 3759, "name": "Bukayo Saka", "slug": "bukayo-saka",
"sport": "football", "gender": null, "image": "https://cdn.datasportsapi.com/v2/players/3759/photo",
"team": { "id": 18, "name": "Arsenal", "slug": "arsenal", "shortName": null, "code": "ARS",
"image": "https://cdn.datasportsapi.com/v2/teams/18/logo" }, "fixture": null, "venue": null },
{ "type": "team", "id": 4021, "name": "Arsenal", "slug": "arsenal", "sport": "football", "gender": "female",
"image": "https://cdn.datasportsapi.com/v2/teams/4021/logo", "team": null, "fixture": null, "venue": null }, … ],
"meta": { "query": "saka", "type": null, "page": 0, "count": 20, "hasNextPage": false } }
// ?q=smith&type=player&page=1 — players only, 20 a page
{ "data": [ { "type": "player", "id": 51102, "name": "Emile Smith Rowe", … }, … ],
"meta": { "query": "smith", "type": "player", "page": 1, "count": 20, "hasNextPage": true } }
// ?q=mourinho
{ "data": [ { "type": "manager", "id": 794950, "name": "José Mourinho", "slug": "jose-mourinho", "sport": "football", "image": null,
"team": null, "fixture": null, "venue": null }, … ],
"meta": { "query": "mourinho", "type": null, "page": 0, "count": 3, "hasNextPage": false } }
// ?q=camp nou — venues (/v2/venues/{id}) and fixtures
{ "data": [
{ "type": "venue", "id": 812, "name": "Spotify Camp Nou", "slug": "spotify-camp-nou", "sport": null, "image": null,
"team": null, "fixture": null,
"venue": { "id": 812, "name": "Spotify Camp Nou", "city": "Barcelona", "country": { "code": "ES", "name": "Spain" }, "capacity": 62652 } },
{ "type": "fixture", "id": 701233, "name": "Barcelona - Real Madrid", "slug": "barcelona-real-madrid", "sport": "football", "image": null,
"team": null, "venue": null,
"fixture": { "home": { "id": 21, "name": "Barcelona", … }, "away": { "id": 19, "name": "Real Madrid", … },
"league": { "id": 8, "name": "LaLiga", … }, "startTime": "2026-10-26T15:15:00.000Z", "status": "finished" } }, … ],
"meta": { "query": "camp nou", "type": null, "page": 0, "count": 5, "hasNextPage": false } }