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

> Busca en Threads y lee perfiles públicos, publicaciones y respuestas como JSON, con me gusta, respuestas, reposts, citas, veces compartido y fechas de publicación.

Lee datos públicos de Threads como JSON mediante la API de tareas asíncronas. Envía `taskType` `SOCIAL` con `platform` `threads` y elige qué leer con `action`. Cada solicitud completada cuesta **0.5 créditos**.

## Solicitud

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

Envía la tarea y luego consulta `GET /v1/async/task/{id}` o recibe su webhook. Consulta [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md).

## Acciones

| `action` | Qué lee | Obligatorio |
| - | - | - |
| `search` (por defecto) | Publicaciones de una palabra clave | `query` |
| `profile` | Un perfil público y sus publicaciones recientes | `username` |
| `post` | Una publicación | `postUrl` |
| `replies` | Las respuestas a una publicación | `postUrl` |

`username` acepta un nombre de usuario o la URL de un perfil. `postUrl` acepta la URL de una publicación, como `https://www.threads.com/@natgeo/post/Dfzi22JJSYp`.

## Parámetros

* `query`: Obligatorio para `search`.
* `limit`: Opcional. `search` y `profile` aceptan de 1 a 50, con 10 por defecto. `replies` acepta de 1 a 500, con 50 por defecto.

## Ejemplo de respuesta

```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 del resultado

* Cada respuesta repite `platform` y `action`. Las listas incluyen `returnedCount`.
* Una publicación tiene `id`, `code`, `url`, `text`, `author`, `authorVerified`, `publishedAt`, `mediaType` (`text`, `image`, `video` o `carousel`), `images`, `videoUrl`, `likeCount`, `replyCount`, `repostCount`, `quoteCount`, `shareCount` e `isReply`. Una respuesta añade `replyTo`, el nombre de usuario al que responde.
* `search` devuelve `posts` en el orden en que Threads los muestra, hasta unos 50.
* `profile` devuelve `id`, `username`, `displayName`, `biography`, `bioLinks`, `avatarUrl`, `profileUrl`, `isVerified`, `isPrivate`, `followerCount`, `threadCount` y `recentPosts`, las 4 a 13 publicaciones más recientes que muestra la página del perfil.
* `post` devuelve `post`. `replies` devuelve `replies`, unas 10 por publicación. `availableCount` es el número de respuestas de la publicación, y `partial: true` marca una lista más corta que ese número, como cuando el autor ocultó respuestas.
* Un perfil o una publicación que no existe o no es pública termina la tarea con `PAGE_UNAVAILABLE`. Solo se cobran las solicitudes completadas.

## Relacionado

* [Instagram](https://docs.querying.ai/es/engines/instagram.md)
* [YouTube](https://docs.querying.ai/es/engines/youtube.md)
* [Resumen de motores](https://docs.querying.ai/es/engines/overview.md)
* [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md)


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