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

# Threads API

> Recherchez sur Threads et lisez en JSON des profils publics, des publications et des réponses, avec mentions J’aime, réponses, republications, citations, partages et dates de publication.

Lisez les données publiques de Threads en JSON via l’API de tâches asynchrones. Envoyez `taskType` `SOCIAL` avec `platform` `threads`, et choisissez ce que vous lisez avec `action`. Une requête terminée coûte **0.5 crédit**.

## Requête

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "SOCIAL", "payload": { "platform": "threads", "action": "search", "query": "running shoes", "limit": 20 } }'
```

Soumettez la tâche, puis interrogez `GET /v1/async/task/{id}` ou recevez son webhook. Voir [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md).

## Actions

| `action` | Contenu lu | Obligatoire |
| - | - | - |
| `search` (par défaut) | Les publications d’un mot-clé | `query` |
| `profile` | Un profil public et ses publications récentes | `username` |
| `post` | Une publication | `postUrl` |
| `replies` | Les réponses à une publication | `postUrl` |

`username` accepte un nom d’utilisateur ou l’URL d’un profil. `postUrl` accepte l’URL d’une publication, comme `https://www.threads.com/@natgeo/post/Dfzi22JJSYp`.

## Paramètres

* `query` : obligatoire pour `search`.
* `limit` : facultatif. `search` et `profile` acceptent de 1 à 50, avec 10 par défaut. `replies` accepte de 1 à 500, avec 50 par défaut.

## Exemple de réponse

```json theme={"theme":"css-variables"}
{
  "platform": "threads",
  "action": "search",
  "query": "running shoes",
  "returnedCount": 1,
  "posts": [
    {
      "id": "4032816753373504516",
      "code": "Df3cXhtEmQE",
      "url": "https://www.threads.com/@bongdgzmn/post/Df3cXhtEmQE",
      "text": "Gave in to the hype as I am also looking for a new pair of daily running shoes.",
      "author": "bongdgzmn",
      "authorVerified": false,
      "publishedAt": "2026-11-18T02:34:01.000Z",
      "mediaType": "carousel",
      "likeCount": 62,
      "replyCount": 42,
      "repostCount": 1,
      "quoteCount": 0,
      "shareCount": 19,
      "isReply": false
    }
  ]
}
```

## Champs du résultat

* Chaque réponse reprend `platform` et `action`. Les listes portent `returnedCount`.
* Une publication a `id`, `code`, `url`, `text`, `author`, `authorVerified`, `publishedAt`, `mediaType` (`text`, `image`, `video` ou `carousel`), `images`, `videoUrl`, `likeCount`, `replyCount`, `repostCount`, `quoteCount`, `shareCount` et `isReply`. Une réponse ajoute `replyTo`, le nom d’utilisateur auquel elle répond.
* `search` renvoie `posts` dans l’ordre où Threads les montre, jusqu’à 50 environ.
* `profile` renvoie `id`, `username`, `displayName`, `biography`, `bioLinks`, `avatarUrl`, `profileUrl`, `isVerified`, `isPrivate`, `followerCount`, `threadCount` et `recentPosts`, les 4 à 13 publications les plus récentes qu’affiche la page du profil.
* `post` renvoie `post`. `replies` renvoie `replies`, une dizaine par publication. `availableCount` est le nombre de réponses de la publication, et `partial: true` signale une liste plus courte que ce nombre, par exemple quand l’auteur a masqué des réponses.
* Un profil ou une publication qui n’existe pas ou n’est pas public termine la tâche avec `PAGE_UNAVAILABLE`. Seules les requêtes terminées sont facturées.

## Voir aussi

* [Instagram](https://docs.querying.ai/fr/engines/instagram.md)
* [YouTube](https://docs.querying.ai/fr/engines/youtube.md)
* [Vue d’ensemble des moteurs](https://docs.querying.ai/fr/engines/overview.md)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.