Search Football Matches API

Find football event candidates by search text before choosing a match-detail, score or statistics request. Requires search. Select a returned event by its actual teams and kickoff context when those fields are available. The match-specific search payload has not been verified; do not assume it shares the general search schema or that club names alone identify a unique match.

API Features

Event-focused query entry The match search contract takes search text without requiring an event ID in advance.

Report-subject selection Check returned match context before assigning a candidate event to an editorial report.

Repeat-fixture disambiguation Distinguish multiple meetings between the same clubs using validated date information.

Event enrichment handoff Carry a confirmed event identifier into the match-detail and statistics families.

Live API Demo

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

API Response (JSON)

{}

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

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

📢

Need Help?

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

Use Cases

Build a fixture finder for editors locating the specific match behind an article draft.
Offer event suggestions before a user opens a match-centre page.
Resolve a named derby to candidate events and require a date check before selecting one.
Prepare a research queue of confirmed event IDs for later period-statistics inspection.

Frequently asked questions

How do I find an event ID before requesting details?

Submit search text, check the returned participants and kickoff context, then use the confirmed match ID as eventid. Club names alone do not identify one fixture.

Which fixed fields does match search return?

This specialized response has not been demonstrated. Inspect its actual fields rather than assuming the dates and status fields from general search are identical.

How do I distinguish repeated meetings between two clubs?

Use available dates, competition and participant context. Ask for confirmation when that context cannot disambiguate the event instead of choosing the first hit.

Related operations

Guides

View Subscription Plans →