Search Football Teams and Matches API

Search football names for typed suggestions and usable team or event identifiers, with a successful empty-result state. Pass required search text, such as Real Madrid. Observed JSON contains status='success' and response.suggestions. Team suggestions include type, id, name, leagueId and leagueName; match suggestions include id, matchDate, status.utcTime, started/finished/cancelled flags and home/away IDs and names. Fields differ by result type. The suggestion score is a search-ranking value, not a match score. An unmatched query returned suggestions=[].

API Features

Typed suggestion routing Use each suggestion's type to choose a team page or an event detail lookup instead of treating all IDs as interchangeable.

Search-to-league context Team hits in the observed response carry leagueId and leagueName alongside the matching name.

Fixture discovery from names Match hits expose participant IDs, kickoff timestamps and state flags for selecting a specific event.

Successful zero-hit response The verified no-match query returns status='success' with an empty suggestions array rather than an entity record.

Live API Demo

GET /api/project/football/get-search-all

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-all?key=<API_KEY>&search=Real+Madrid'

curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-all?key=<API_KEY>&search=Real+Madrid'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Build one search box that routes a Real Madrid team hit to a club page and a derby hit to a match centre.
Add an onboarding demonstration contrasting populated suggestions with a clean no-results screen.
Link an editor's club-name query to dated fixture candidates before selecting a match report subject.
Save typed search identifiers in a favourites list without merging team and match namespaces.

Frequently asked questions

How do I find a team ID by name?

Pass required search text, inspect each suggestion's type and club context, then retain the matching team id. Real Madrid is a public example, not a guaranteed result.

Is a suggestion's score the match score?

No. It is a search-ranking value. Read match scores from fixtures or a separately validated score response, and parse each suggestion type independently.

Does an empty suggestions array mean failure?

Not necessarily. A demonstrated unmatched query returned status='success' with suggestions=[]. Check HTTP and business status before displaying no matches.

Related operations

Guides

View Subscription Plans →