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

# API Threads

> Options de publication à l'aide de l'API Threads

<Info>
  La publication sur Threads récupère le média depuis votre URL via le crawler côté serveur de Meta.
  Si vous voyez le code d'erreur Ayrshare 379 — en particulier associé à une erreur Instagram 440 ou 138 lors de la même
  publication — consultez [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked).
</Info>

## Publier sur Threads

JSON pour une publication de base avec un lien et une image à l'aide de l'API Threads :

```json Threads Post theme={"system"}
{
  "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["threads"]
}
```

L'API Threads a les exigences et restrictions suivantes :

<ul class="custom-bullets">
  <li>
    Threads prévisualisera automatiquement le lien dans la publication sauf si une image ou une vidéo est
    incluse. Dans l'exemple ci-dessus, c'est l'image qui s'affichera. Retirer l'image affichera l'aperçu
    du lien.
  </li>

  <li>Les profils Threads sont limités à 250 publications publiées via API sur une période glissante de 24 heures.</li>
  <li>Threads n'autorise qu'un seul hashtag par publication.</li>
  <li>Les utilisateurs Threads @mentionnés recevront une notification.</li>
  <li>Maximum 500 caractères de publication.</li>

  <li>
    Les publications multi-images/vidéos sont prises en charge et envoyées en carrousel. Vous pouvez envoyer jusqu'à 20 vidéos et
    images.
  </li>

  <li>
    Threads ne prend pas en charge la suppression via une API. Les suppressions doivent être effectuées manuellement dans l'application Threads.
  </li>

  <li>
    Si votre vidéo ne se termine pas par une extension vidéo connue telle que mp4, utilisez le paramètre `isVideo`.
    Consultez le [point de terminaison /post](/apis/post/post) pour plus de détails.
  </li>

  <li>
    Threads prend également en charge l'envoi de médias sans texte de publication. Si vous ne souhaitez pas inclure de texte,
    envoyez une chaîne vide `post: ""`.
  </li>

  <li>
    Consultez [Threads Media Guidelines](/media-guidelines/threads) et [Threads
    Authorization](/dashboard/connect-social-accounts/threads) pour plus d'informations.
  </li>
</ul>

## Options Threads

Vous pouvez définir des options supplémentaires pour une publication en utilisant le paramètre `threadsOptions`.

```json Threads Options theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"],
    "thread": true,
    "threadNumber": true,
    "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads
  }
}
```

Les options Threads sont des champs facultatifs qui peuvent être utilisés pour contrôler la publication.

<ParamField body="allowCountries" type="array of strings">
  Restreignez les publications à des pays spécifiques à l'aide de codes pays. Utilisez les [codes pays](/iso-codes/country).

  Disponible uniquement si Meta a activé les restrictions géographiques pour votre compte.

  Consultez [Restrictions géographiques Threads](/apis/post/social-networks/threads#geo-restrictions) pour plus d'informations.
</ParamField>

<ParamField body="thread" type="boolean" default={false}>
  Divisez de longues publications en une série de threads connectés avec numérotation et médias facultatifs.

  Consultez [Thread](/apis/post/social-networks/threads#thread) pour plus d'informations.
</ParamField>

<ParamField body="threadNumber" type="boolean" default={false}>
  Ajoute automatiquement des numéros à la fin de chaque thread au format 1/n.

  Nécessite `thread: true`.
</ParamField>

<ParamField body="mediaUrls" type="array of strings">
  Ajoutez des objets média à un thread de threads. Un objet média sera ajouté à chaque thread dans l'ordre.

  Utilisez `null` pour ignorer le média d'un thread spécifique. Utilisez des objets avec plusieurs URLs pour plusieurs médias par thread.

  Consultez [Média de thread](/apis/post/social-networks/threads#thread-media) pour plus d'informations.
</ParamField>

## Ajouter des sauts de ligne ou du texte enrichi à une publication Threads

Les sauts de ligne Threads peuvent être ajoutés à une publication avec un [caractère de nouvelle ligne](/apis/post/post#line-breaks) spécial.

Le texte enrichi, tel que le gras ou l'italique, peut être ajouté à une publication Threads avec quelques [éléments HTML](/apis/post/overview#rich-text-posts).

## Carrousel d'images et de vidéos

Vous pouvez publier plusieurs images ou vidéos sur Threads sous forme de carrousel ; jusqu'à un total combiné de 20 images ou vidéos peuvent être utilisées dans un carrousel. Ajoutez simplement vos images ou vidéos supplémentaires au tableau `mediaUrls` et le carrousel sera automatiquement créé.

```json theme={"system"}
"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos
```

Les URLs vidéo doivent se terminer par une extension connue telle que mp4.

## Limites de caractères

Consultez [Threads Character Limits](/help-center/technical-support/character_limits#threads-character-limits) pour plus d'informations.

## Restrictions géographiques

Vous pouvez restreindre une publication à un ou plusieurs pays spécifiques en utilisant le tableau `allowCountries`.

```json theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}
```

<ul class="custom-bullets">
  <li>
    `allowCountries` : un tableau de codes pays à autoriser. Voir les [codes pays](/iso-codes/country).
  </li>
</ul>

<Warning>
  Les restrictions géographiques (geo-gating) sur Threads ne sont disponibles que si Meta a activé cette fonctionnalité pour votre compte.

  Meta décide quels comptes Threads sont éligibles aux restrictions géographiques en fonction de facteurs tels que la vérification du compte, le nombre d'abonnés ou le statut de créateur de contenu.
  Si votre compte est éligible, vous verrez les paramètres géographiques (icône globe) dans le compositeur de publication lors de la création d'une nouvelle publication Threads.

  Vous pouvez vérifier si un User Profile est éligible aux restrictions géographiques Threads en vérifiant la propriété `isEligibleForGeoRestrictions` dans le point de terminaison [/user](/apis/user/profile-details).
</Warning>

## Mentions Threads

Mentionnez un autre handle Threads en ajoutant @handle dans le texte de la publication. Par exemple :

```json theme={"system"}
{
  "post": "The best social media API @Ayrshare ever!",
  "mediaUrls": ["https://images.com"],
  "platforms": ["threads"]
}
```

<Warning>
  L'utilisateur @mentionné sera notifié de la mention. Consultez les [règles
  importantes](/testing/post-verification#mentions) sur les mentions.
</Warning>

Si le quota est atteint, un message d'erreur sera renvoyé.

## Thread

Un thread Threads, également appelé threadstorm, est une série connectée de publications sur Threads qui vous permet de partager des idées plus longues au-delà de la limite de caractères d'une seule publication, apparaissant comme un récit continu lorsqu'elles sont vues ensemble.

### Publier un thread

Un thread Threads peut être publié via l'API. Un thread est une publication divisée en un ensemble de publications de réponse associées entre elles dans Threads. Vous pouvez soit diviser automatiquement la publication, soit spécifier les [ruptures de thread](/apis/post/social-networks/threads#thread-breaks) dans le texte de la publication.

```json Threads Thread theme={"system"}
{
  "threadsOptions": {
    "thread": true,        // required for threadstorm
    "threadNumber": true,  // optional to add numbers to each thread
    "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...]  // optional one media object is added to a thread in order
  }
}
```

<ul class="custom-bullets">
  <li>
    `thread: true` pour diviser automatiquement le texte de la publication en threads sur la base des sauts de ligne.
  </li>

  <li>
    `threadNumber: true` pour ajouter automatiquement des numéros à la fin des threads au format 1/n.
    Par exemple, le 2e des 5 threads aura la mention : 2/5
  </li>

  <li>
    `mediaUrls: [array of urls]` pour ajouter chaque objet média, image ou vidéo, à un thread dans l'ordre.
    Un seul objet média est ajouté à un thread dans l'ordre.
  </li>
</ul>

#### Média de thread

##### Ignorer un média

Ignorez le média d'un thread en utilisant `null` dans le tableau. Par exemple :

`["https://site.com/image1.png", null, "https://site.com/image2.png"]`

Cela placera image1 dans la première publication, aucune image dans la deuxième et image2 dans la troisième.

##### Plusieurs médias

Plusieurs objets média peuvent être ajoutés à une seule publication au sein d'un thread en ajoutant un objet `{}` avec les URLs de média dans le tableau `mediaUrls`. Toutes clés d'objet uniques peuvent être utilisées. Par exemple :

```json Threads Thread with Multiple Media URLs theme={"system"}
{
  "threadsOptions": {
    "thread": true,
    "threadNumber": true,
    "mediaUrls": [
      "https://img.ayrshare.com/random/photo-1.jpg",
      {
        "1": "https://img.ayrshare.com/random/photo-2.jpg",
        "2": "https://img.ayrshare.com/random/photo-3.jpg"
      },
      "https://img.ayrshare.com/random/photo-4.jpg"
    ]
  }
}
```

Dans cet exemple, la première publication contiendra photo-1.jpg, la deuxième photo-2.jpg et photo-3.jpg, et la troisième photo-4.jpg.

#### Ruptures de thread

Ayrshare divise automatiquement le texte de la publication en publications de longueur appropriée (> 500 caractères) pour Threads. Lors de la création de threads, nous privilégions le maintien de phrases complètes dans une même publication quand c'est possible. Si une phrase ne rentre pas, nous coupons entre les phrases. Pour les phrases très longues, nous coupons entre les mots. Dans les rares cas où un mot est trop long, nous coupons le mot lui-même.

Vous pouvez également ajouter manuellement des paragraphes avec `\n\n` dans le texte de la publication pour indiquer qu'un nouveau thread doit être créé. Si `\n\n` figure dans le texte de la publication, nous ne diviserons pas automatiquement la publication en threads.

Par exemple :

```json Example Threads Thread theme={"system"}
{
  "post": "This is post 1\n\nThis is post 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

produira deux publications dans le thread.

Si vous souhaitez ajouter des paragraphes sans diviser en publications, utilisez `\u2063\n\u2063\n`.

```json Threads Thread with Paragraphs theme={"system"}
{
  "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

produira une publication avec deux paragraphes puisque la publication fait moins de 500 caractères.

### Supprimer un thread

Threads ne prend pas en charge la suppression via une API. Les suppressions doivent être effectuées manuellement dans l'application Threads.
