Search Football Competitions API

Find competition candidates by name and validate a league identifier for details, fixture lists or standings. Requires search text. Inspect this operation's response for league identities and disambiguating context before reuse. Its field names and no-result behaviour have not been verified. A discoverable competition is not proof that every related statistics or standings operation supports it.

API Features

Competition-name entry Search provides a name-based route into league-oriented workflows without a preselected leagueid.

League-detail verification step Resolve a chosen candidate through league details before labeling related data.

Saved competition references Keep validated competition identifiers for later table and fixture requests.

Discovery versus coverage distinction League discovery must be checked separately from detailed-data availability.

Live API Demo

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

API Response (JSON)

{}

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

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

📢

Need Help?

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

Use Cases

Create a competition autocomplete that supplies confirmed IDs to a standings form.
Help users bookmark the intended league when several competitions have similar names.
Audit whether a requested domestic competition can be discovered without relying on an incomplete directory.
Build an onboarding selector that checks league identity before creating a league-specific page.

Frequently asked questions

How can I find the Premier League ID?

Search Premier League and verify the selected competition before retaining its ID as leagueid. The demonstrated public overall-standings example used 47.

Are league-search fields and empty results fixed?

The response has not been demonstrated. Verify its actual identity fields and no-result format rather than copying another search parser.

Does discovering a league guarantee every related feature?

No. Check standings, lineups, odds and statistics separately for the target competition and events.

Related operations

Guides

View Subscription Plans →