Search events
On this page
How to search fixtures by team, league, and date
Use POST /v1/events/search to find fixtures by team name, league, and date range across supported bookmakers. Search accepts 1 to 20 queries per call, 1 to 50 results per query, and 200 events per call, costs 0 API credits, and returns exact confidence for head-to-head matches or fuzzy for single-side matches.
POST /v1/events/search
{
"bookmaker": "sportybet",
"sport": "football",
"queries": [
{"q": "Arsenal vs Chelsea", "from": "2026-11-03", "to": "2026-11-04", "limit": 10},
{"q": "Real Madrid", "league": "La Liga", "limit": 10}
],
"include_markets": true,
"market_filter": ["1X2", "Over/Under"],
"include_unbookable": false,
"detail": "agent"
}Pass one team name (Real Madrid, Man Utd) for a single-team search, or separate two teams with vs, v, or - (Arsenal vs Chelsea, Arsenal v Chelsea, Arsenal - Chelsea) for a head-to-head fixture. Team names are normalized automatically, so common aliases (Man Utd, PSG) and club suffixes (FC, AFC, CF) match without extra formatting. Head-to-head queries return confidence: "exact" when both teams match the fixture and confidence: "fuzzy" when only one side matches.
{
"results": [
{
"query": "Arsenal Chelsea",
"events": [
{
"event_id": "sr:match:123",
"home": "Arsenal",
"away": "Chelsea",
"league": "Premier League",
"kickoff": "2026-11-03T20:00:00Z",
"live": false,
"score": "",
"confidence": "exact",
"bookable": true,
"markets": [
{"market_id": "18", "canonical_market": "Over/Under",
"line": "2.5",
"outcomes": [
{"outcome_id": "12", "canonical_outcome": "Over", "odds": "1.90"}
]}
]
}
],
"has_more": false,
"next_offset": null
}
],
"request_id": "req_..."
}What are the search limits and what does search cost
A Manage Bet Codes event search costs 0 API credits and is keyed and rate-limited instead. Search accepts 1 to 20 queries per call, 1 to 50 results per query, and 200 events per call, returns only the requested markets or the top 3 without a filter, and counts against the request rate and the daily search cap in limits.
| Item | Limit |
|---|---|
| Queries | 1 to 20 for each call |
| Results | 1 to 50 for each query |
| Events | 200 for each call |
| Markets | The requested markets. The top 3 if there is no filter. |
| Unbookable events | Add with include_unbookable. They return bookable: false. |
| Detail | compact, full, or agent |
| Price | 0 credits. The call is keyed and rate-limited. |
Search and resolve count against the request rate and the daily search cap. See limits.
Which other event routes list single queries and markets
The Manage Bet Codes API also provides GET /v1/events?q=arsenal for a single-query search and GET /v1/events/{event_id}/markets for one event's markets. A missing event returns 404 event_not_found, a missing market returns 404 market_not_found, and a full daily search cap returns 429 search_quota_exhausted.
| Route | Purpose |
|---|---|
GET /v1/events?q=arsenal | Single-query search. |
GET /v1/events/{event_id}/markets | List one event's markets. |
A missing event returns 404 event_not_found. A missing market returns 404 market_not_found. A full daily search cap returns 429 search_quota_exhausted.