API Reference

Search events

get
https://search.fansunitedapi.com/v1/events

Search match events for odds ID mapping. Supports text search on team names and filtering by date range, sport, and competition. All parameters are optional — any combination is valid.

Query Params
string
required

Client ID

string

Filter by competition ID (e.g. fb:c:1)

string

Filter matches with start_time >= this value. ISO8601 date or datetime (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)

string
required

Client API key

integer
Defaults to 10

Maximum number of results to return (1-100)

number

Minimum percentage of query terms that must match (0–100). Controls minimum_should_match on the fuzzy multi-match query. If omitted, defaults to 80%.

integer
Defaults to 1

Page number (1-based)

string

Text search on team names. If empty or null, returns all results

string

Filter by sport (e.g. FOOTBALL)

string

Filter matches with start_time <= this value. ISO8601 date or datetime (e.g. 2026-05-07 or 2026-05-07T23:59:59Z)

Responses

Updated about 3 hours ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 3 hours ago