Search

Global search

Multi-entity search across teams, players, leagues, seasons, and matches. Returns grouped result buckets; the type param narrows to a single entity. Each bucket is limited (not page-based) and constrained to the caller's accessible leagues.

Plan: Available on the free plan.

get/search

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/search
  • Auth: HTTP bearer

Query parameters

qstring required

Search query, minimum 2 characters. Errors with missing_query if absent or too short.

typestring

Entity to search. Allowed: all, teams, players, leagues, seasons, matches. Invalid values error with invalid_type.

limitinteger

Max results per entity bucket, clamped between 1 and 25.

Response

Successful response

successboolean
metaMeta

Request metadata: usage counters, plan access, and pagination when applicable.

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.