Search content

get

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

Search across multiple content types (football matches, quizzes, polls, games, etc.) using a unified interface.

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

Query Params

client_id

string

required

Client ID

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

type

string

enum

Filter by specific content type. If null, searches all types. Valid values: football_match, classic_quiz, personality_quiz, poll, match_quiz, top_x, custom_event_game, custom_standings_game, custom_bracket_game, either_or

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

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