Get Football Head-to-Head Data API

Request head-to-head information for the two participants associated with a selected football event. Requires eventid, not separate home and away team IDs. No head-to-head response sample has been verified. Check the returned meetings, date span and match identifiers before summarizing a rivalry; returned records do not establish a complete history or a prediction of the next result.

API Features

Fixture-defined matchup selection An event ID identifies the opposing teams for the head-to-head request.

Returned-meetings scope Summarize only the meetings supplied after inspecting the actual response.

Historical context separation Label prior results as context rather than treating them as predictive probabilities.

Rivalry record provenance Retain validated meeting identifiers and dates when building a matchup history.

Live API Demo

GET /api/project/football/get-head-to-head-by-event-id

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/football/get-head-to-head-by-event-id?key=<API_KEY>&eventid=5868072'

curl -X GET 'https://api.opendata-api.com/api/project/football/get-head-to-head-by-event-id?key=<API_KEY>&eventid=5868072'

📢

Need Help?

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

Use Cases

Add a previous-meetings section to a preview for an event's two clubs.
Prepare an editorial rivalry brief whose date coverage matches the returned records.
Check overlap between returned historical meetings and an existing fixture archive.
Create a supporter-site comparison page that distinguishes unavailable H2H data from no past meetings.

Frequently asked questions

Do I pass two team IDs for head-to-head history?

No. Required eventid identifies the matchup through a selected fixture; separate home and away team inputs are not declared.

How much head-to-head history is available?

No demonstrated payload establishes the range. Check returned meetings and dates instead of claiming a complete historical archive.

Can previous meetings directly provide win probabilities?

No. Historical results provide context, not calibrated prediction probabilities or a guarantee of the next result.

Related operations

Guides

View Subscription Plans →