> ## 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

> Pesquise no Threads e leia perfis públicos, publicações e respostas em JSON, com curtidas, respostas, republicações, citações, compartilhamentos e horários de publicação.

Leia dados públicos do Threads em JSON pela API de tarefas assíncronas. Envie `taskType` `SOCIAL` com `platform` `threads` e escolha o que ler com `action`. Cada requisição concluída custa **0.5 crédito**.

## Requisição

```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 } }'
```

Envie a tarefa e depois consulte `GET /v1/async/task/{id}` ou receba o webhook. Veja [Tarefas assíncronas](https://docs.querying.ai/pt/concepts/async-tasks.md).

## Ações

| `action` | O que lê | Obrigatório |
| - | - | - |
| `search` (padrão) | Publicações de uma palavra-chave | `query` |
| `profile` | Um perfil público e suas publicações recentes | `username` |
| `post` | Uma publicação | `postUrl` |
| `replies` | As respostas a uma publicação | `postUrl` |

`username` aceita um nome de usuário ou o URL de um perfil. `postUrl` aceita o URL de uma publicação, como `https://www.threads.com/@natgeo/post/Dfzi22JJSYp`.

## Parâmetros

* `query`: Obrigatório para `search`.
* `limit`: Opcional. `search` e `profile` aceitam de 1 a 50, com padrão 10. `replies` aceita de 1 a 500, com padrão 50.

## Exemplo de resposta

```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
    }
  ]
}
```

## Campos do resultado

* Toda resposta repete `platform` e `action`. As listas trazem `returnedCount`.
* Uma publicação tem `id`, `code`, `url`, `text`, `author`, `authorVerified`, `publishedAt`, `mediaType` (`text`, `image`, `video` ou `carousel`), `images`, `videoUrl`, `likeCount`, `replyCount`, `repostCount`, `quoteCount`, `shareCount` e `isReply`. Uma resposta acrescenta `replyTo`, o nome de usuário a quem ela responde.
* `search` retorna `posts` na ordem em que o Threads os mostra, até cerca de 50.
* `profile` retorna `id`, `username`, `displayName`, `biography`, `bioLinks`, `avatarUrl`, `profileUrl`, `isVerified`, `isPrivate`, `followerCount`, `threadCount` e `recentPosts`, as 4 a 13 publicações mais recentes que a página do perfil mostra.
* `post` retorna `post`. `replies` retorna `replies`, cerca de 10 por publicação. `availableCount` é a contagem de respostas da publicação, e `partial: true` marca uma lista menor que essa contagem, como quando o autor ocultou respostas.
* Um perfil ou publicação que não existe ou não é público encerra a tarefa com `PAGE_UNAVAILABLE`. Só as requisições concluídas são cobradas.

## Relacionado

* [Instagram](https://docs.querying.ai/pt/engines/instagram.md)
* [YouTube](https://docs.querying.ai/pt/engines/youtube.md)
* [Visão geral dos motores](https://docs.querying.ai/pt/engines/overview.md)
* [Créditos e limites](https://docs.querying.ai/pt/concepts/credits-and-limits.md)


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