Search sport entities

get

https://search.fansunitedapi.com/v1/entities/search

Search sport entities (venues, teams, athletes, coaches, staff, competitions, countries) with optional filters. Team, athlete and coach entities use content_type COMPETITOR and are returned with their full data payload. Team and athlete documents may include a history array of per-season snapshots (season_id, related, assets); team related may include coaching entries (COACH / ASSISTANT_COACH / FITNESS_COACH / GOALKEEPERS_COACH) referencing coach ids in {sport}:coach:{id} format, and support staff entries (ANALYST / DOCTOR / PHYSIOTHERAPIST / MASSEUR / KIT_MANAGER / ADMINISTRATOR / TEAM_MANAGER / TRANSLATOR / VIDEOGRAPHER) referencing staff ids in {sport}:staff:{id} format.

Caching: 10 minutes. Can be configured in Management Portal by going to Features -> Cache TTL

Query Params

client_id

string

required

Client ID

content_type

string

enum

Filter by entity content type. Valid values: venue, athlete, team, competition, country, coach, staff.

ids

string

Find specific items by IDs (comma-separated, e.g., 'quiz-123,poll-456'). Searches in id field. When provided, query parameter is ignored

key

string

required

Client API key

limit

integer

Defaults to 10

Maximum number of results to return (1-100)

mode

string

enum

Defaults to CASE_INSENSITIVE

Search matching mode: CASE_INSENSITIVE (default), CASE_SENSITIVE, or FULL_MATCH

Allowed:

page

integer

Defaults to 1

Page number (1-based)

query

string

Search query string. If empty or null, returns all results

relationship

string

Filter by relationship type (must be used with value). E.g., TEAM, COMPETITION

sport

string

Filter by sport. Valid values: football

value

string

Filter by relationship value (must be used with relationship). E.g., fb:t:america

Responses

200Search results with pagination metadata. Returns array of content items with their type and data.

400Bad request. Possible errors: Missing required parameter (client_id) Invalid content type Invalid limit (must be 1-100) Invalid page number (must be >= 1) Pagination limit exceeded (max 10,000 items) Invalid search mode

500Internal server error during search execution