Aller au contenu

Recherche par nom

GET
/v1/search
curl --request GET \
--url 'https://example.com/v1/search?q=paris&type=competition&lang=ar'

Trouve compétitions, équipes et personnes par leur nom, en français ou en anglais, sans tenir compte des accents ni de la casse : le point d’entrée pour passer d’un nom (« PSG », « Mbappé ») à l’id qu’attendent les autres routes. Pas de pagination : limit borne le nombre de résultats. Données de référentiel, cachées un jour.

q
required

Nom cherché, sans tenir compte des accents ni de la casse : chaque mot doit commencer un mot du nom (« mar » trouve Martin, pas Omar), dans n’importe quel ordre (de 1 à 5 mots, dont un d’au moins 3 caractères)

string
<= 100 characters

Example

paris

Nom cherché, sans tenir compte des accents ni de la casse : chaque mot doit commencer un mot du nom (« mar » trouve Martin, pas Omar), dans n’importe quel ordre (de 1 à 5 mots, dont un d’au moins 3 caractères)

type

Un seul type d’entité ; par défaut, compétitions, équipes et personnes

string
Allowed values: competition team person

Un seul type d’entité ; par défaut, compétitions, équipes et personnes

limit

Nombre de résultats, de 1 à 50 (défaut : 10)

integer
>= 1 <= 50

Nombre de résultats, de 1 à 50 (défaut : 10)

lang

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

string
Allowed values: ar da de en es fa fi fr it ja ko nl no pl pt ro ru sv th tr zh

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

Les entités trouvées, les meilleures d’abord ; liste vide sans résultat

Media typeapplication/json
object
data
required

Les meilleurs résultats d’abord : nom identique, puis nom qui commence par la recherche, puis le reste ; à égalité, le nom le plus court

Array
One of: discriminator: type

Une compétition trouvée : sa fiche et ses saisons sont sous /v1/competitions

object
type
required
string
Allowed values: competition
id
required

Identifiant opaque d’une compétition

string
>= 1 characters
name
required
string
nullable
logo
required
Any of:

Logo d’une compétition, en PNG carré : small en 32 × 32 px (liste, en-tête de bloc), large en 100 × 100 px (fiche). Servi pour les compétitions de football, null pour les autres sports. Une compétition dont iDalgo n’a pas le fichier répond 404 à cette adresse : prévoyez un repli (nom seul)

object
small
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
large
required

Une image servie par le CDN des médias iDalgo

object
url
required

Adresse absolue de l’image, servie par le CDN

string format: uri
width
required

Largeur, en pixels

integer
height
required

Hauteur, en pixels

integer
sport
required
Any of:

Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)

object
id
required

Identifiant opaque d’un sport

string
>= 1 characters
code
required

Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
name
required
string
nullable
currentSeason
required
Any of:

Une saison de compétition (« Ligue 1 2026/2027 »)

object
id
required

Identifiant opaque d’une saison de compétition

string
>= 1 characters
name
required
string
nullable
meta
required

Méta d’une réponse /v1 ou d’un module

object
generatedAt
required

Date de génération de la réponse

string format: date-time
version
required

Version du contrat de la réponse : v1 pour une ressource /v1, celle du module pour un module (/modules/<nom>/v<n> → v<n>)

string
Allowed values: v1
lang
required

Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.

string
Allowed values: ar da de en es fa fi fr it ja ko nl no pl pt ro ru sv th tr zh
links
required
object
self
required

Chemin de la ressource, paramètres triés

string

Example

{
"data": [
{
"type": "competition"
}
],
"meta": {
"version": "v1",
"lang": "ar"
}
}

Contenu inchangé depuis l’ETag envoyé en If-None-Match

Paramètre invalide ou inconnu

Media typeapplication/problem+json

Erreur au format application/problem+json (RFC 9457)

object
type
required
string
title
required
string
status
required
integer
code
required

Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.

string
>= 1 characters
detail

Explication propre à cette requête

string
requestId

Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support

string

Example generated

{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"requestId": "example"
}