API Articles

Cet objet représente les articles du site Le Temps.

Endpoints disponibles

Recherche d’articles
Détail d’un article

Recherche d’articles

URL : https://www.letemps.ch/api/articles
Type d’appel : GET

Paramètre	Type	Obligatoire	Commentaire	Exemple
sirius_id	`string`	Non		c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA
title	`string`	Non	La chaîne qu’on va chercher dans les titres d’articles	Guerre en Ukraine
page	`integer`	Non	Le numéro de page que vous souhaitez	2

Exemple d'appel

https://www.letemps.ch/api/articles?sirius_id=c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA

⚠️

Le critères de recherche sont cumulables, si vous précisez un sirius_id ET un titre la recherche filtrera sur ces deux critères.
Seuls les articles publiés peuvent être affichés.
Ces paramètres ne sont pas obligatoires. Si vous ne les renseignez pas les derniers articles publiés seront affichés.
La liste renvoyée est paginée. Utilisez le paramètre optionnel page pour ajouter un offset. Par exemple un paramètre page = 1 (équivalent à aucun paramètre page fourni) affichera les 21 derniers articles publiés, alors qu’un paramètre page = 2 affichera les 21 précédents.

L’appel renvoie un statut 200 à partir du moment où la recherche s’effectue correctement, même si elle ne trouve pas de résultats.
Si la requête est valable il renvoie également un tableau articles contenant les objets trouvés.

Réponse correcte

{
    "articles": [
        {
            "id": 123456,
            "sirius_id": "c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA",
            "title": "A Kiev, l’intensification des attaques russes met à l’épreuve le moral des habitants",
            "subtitle": "Lorem Ipsum",
            "free": true,
            "genre": "Factuel",
            "publication_date": "2025-07-01T11:40:11.021+02:00",
            "authors": [
                1234,
                2345
            ]
        },
        {...}
    ]
}

Détail d’un article

URL : https://www.letemps.ch/api/articles/:id
Type d’appel : GET

Paramètre	Type	Obligatoire	Exemple
id (dans l’url directement)	`integer`	Oui	123456

Exemple d'appel

https://www.letemps.ch/api/articles/123456

L’appel renvoie un statut 200 si l’article a bien été trouvé, ou un statut 404 en cas d’échec.
Si l’article a été trouvé il renvoie également un objet article, sinon il renvoie un code d’erreur.

Réponse correcte

{
    "article": {
        "id": 123456,
        "sirius_id": "c3RnLWxldGVtcHM6QXJ0aWNsZTo3ODg2MA",
        "title": "Lorem ipsum",
        "subtitle": "Lorem ipsum dolor sit amet",
        "free": true,
        "genre": "Factuel",
        "publication_date": "2025-07-01T11:40:11.021+02:00",
        "authors": [
          1234,
          23456
        ],
        "abstract": "Lorem ipsum",
        "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
        "transparency": "Lorem ipsum"            
    }
}

Réponse erronnée

{
    "code": "not_found"
}