> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkuma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Thématiques

> Récupérez les thématiques disponibles pour un type de commande donné, avec filtrage par langue.

## Description

Retourne la liste des thématiques disponibles pour un type de commande (`basic`, `standard` ou `premium`). Vous pouvez filtrer les résultats par langue.

Cet endpoint ne nécessite pas d'authentification.

<Info>
  La thématique détermine le secteur d'activité du site hôte sur lequel sera publié votre backlink. Choisissez une thématique cohérente avec votre site cible pour maximiser la pertinence du lien.
</Info>

***

## Paramètres

### Paramètre de chemin (path)

<ParamField path="orderType" type="string" required>
  Type de commande pour lequel vous souhaitez récupérer les thématiques.

  Valeurs acceptées : `basic`, `standard`, `premium`
</ParamField>

### Paramètre de requête (query)

<ParamField query="lang" type="string">
  Filtre les thématiques disponibles dans la langue souhaitée.

  Valeurs acceptées : `fr`, `en`, `es`, `de`, `it`

  Par défaut : toutes les langues sont retournées.
</ParamField>

***

## Requête

### Exemple cURL : thématiques basic en français

```bash theme={null}
curl "https://app.linkuma.com/api/v1/thematics/basic?lang=fr" \
  -H "Accept: application/json"
```

### Exemple cURL : thématiques premium en anglais

```bash theme={null}
curl "https://app.linkuma.com/api/v1/thematics/premium?lang=en" \
  -H "Accept: application/json"
```

***

## Réponse

<ResponseField name="data" type="array">
  Liste des thématiques disponibles pour le type de commande demandé.

  <Expandable title="Propriétés d'une thématique">
    <ResponseField name="id" type="integer">
      Identifiant unique de la thématique. À utiliser dans le champ `thematic_id` lors d'une commande.
    </ResponseField>

    <ResponseField name="label" type="string">
      Nom de la thématique dans la langue retournée.
    </ResponseField>

    <ResponseField name="slug" type="string">
      Identifiant textuel de la thématique.
    </ResponseField>

    <ResponseField name="lang" type="string">
      Code langue de la thématique (`fr`, `en`, `es`, `de`, `it`).
    </ResponseField>

    <ResponseField name="sites_count" type="integer">
      Nombre de sites disponibles dans cette thématique pour le type de commande sélectionné.
    </ResponseField>
  </Expandable>
</ResponseField>

### Exemple de réponse

```json theme={null}
{
  "data": [
    {
      "id": 12,
      "label": "High-Tech & Informatique",
      "slug": "high-tech-informatique",
      "lang": "fr",
      "sites_count": 148
    },
    {
      "id": 13,
      "label": "Marketing & SEO",
      "slug": "marketing-seo",
      "lang": "fr",
      "sites_count": 95
    },
    {
      "id": 14,
      "label": "Finance & Investissement",
      "slug": "finance-investissement",
      "lang": "fr",
      "sites_count": 73
    },
    {
      "id": 15,
      "label": "Santé & Bien-être",
      "slug": "sante-bien-etre",
      "lang": "fr",
      "sites_count": 112
    },
    {
      "id": 16,
      "label": "Immobilier",
      "slug": "immobilier",
      "lang": "fr",
      "sites_count": 60
    }
  ]
}
```

***

## Bonnes pratiques pour le choix de la thématique

<Info>
  La pertinence thématique est le critère n°1 de qualité d'un backlink en 2026. Un lien depuis un site thématiquement cohérent vaut jusqu'à **10× plus** qu'un lien depuis un site généraliste à DA supérieur.
</Info>

<AccordionGroup>
  <Accordion title="Choisir la thématique exacte de votre site">
    Si votre site est un e-commerce de chaussures, choisissez la thématique Mode/Fashion plutôt que Généraliste. Google analyse la cohérence thématique entre le site source et votre page cible.
  </Accordion>

  <Accordion title="Diversifier avec des thématiques adjacentes">
    Ne commandez pas 100% de vos liens dans la même thématique. Un profil naturel inclut des liens depuis des thématiques connexes. Ex : un site de fitness peut recevoir des liens depuis Santé, Sport, Nutrition et Lifestyle.
  </Accordion>

  <Accordion title="Filtrer par langue pour le SEO local/international">
    Utilisez le paramètre `lang` pour cibler des sites dans la langue de votre audience. Un site français qui cible le marché allemand doit obtenir des liens depuis des sites en allemand (`lang=de`).
  </Accordion>

  <Accordion title="Vérifier la disponibilité avant de commander">
    Le champ `sites_count` indique combien de sites sont disponibles dans chaque thématique. Si une thématique a peu de sites, élargissez à une thématique adjacente pour maintenir la qualité.
  </Accordion>
</AccordionGroup>