Skip to main content
GET
Search / list football competitors (teams & national sides)

What it returns

Substring search over competitor names. Each result carries icon_path — a club crest for clubs or a country flag for national sides — and is_national so you can tell them apart. Logos are re-hosted on our CDN, so icon_path is a stable URL you can serve directly.

Required scope

Authenticates with X-API-Key; the key’s sport_allowlist must include soccer.

Authorizations

X-API-Key
string
header
required

Query Parameters

search
string | null

Substring match on competitor name

limit
integer
default:50
Required range: 1 <= x <= 200

Response

Successful Response

The response is of type Response List Competitors Soccer V1 Competitors Get · object.

Last modified on June 20, 2026