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

> Search Threads and read public profiles, posts and replies as JSON, with likes, replies, reposts, quotes, shares and publish times.

Read public Threads data as JSON through the async task API. Send `taskType` `SOCIAL` with `platform` `threads`, and pick what to read with `action`. A completed request costs **0.5 credits**.

## Request

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

Submit the task, then poll `GET /v1/async/task/{id}` or receive its webhook. See [Async tasks](https://docs.querying.ai/concepts/async-tasks.md).

## Actions

| `action` | Reads | Required |
| - | - | - |
| `search` (default) | Posts for a keyword | `query` |
| `profile` | A public profile and its recent posts | `username` |
| `post` | One post | `postUrl` |
| `replies` | A post's replies | `postUrl` |

`username` takes a username or a profile URL. `postUrl` takes a post URL, such as `https://www.threads.com/@natgeo/post/Dfzi22JJSYp`.

## Parameters

* `query`: Required for `search`.
* `limit`: Optional. `search` and `profile` take 1 to 50, default 10. `replies` takes 1 to 500, default 50.

## Response example

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

## Result fields

* Every response echoes `platform` and `action`. Lists carry `returnedCount`.
* A post has `id`, `code`, `url`, `text`, `author`, `authorVerified`, `publishedAt`, `mediaType` (`text`, `image`, `video` or `carousel`), `images`, `videoUrl`, `likeCount`, `replyCount`, `repostCount`, `quoteCount`, `shareCount` and `isReply`. A reply adds `replyTo`, the username it answers.
* `search` returns `posts` in the order Threads shows them, up to about 50.
* `profile` returns `id`, `username`, `displayName`, `biography`, `bioLinks`, `avatarUrl`, `profileUrl`, `isVerified`, `isPrivate`, `followerCount`, `threadCount` and `recentPosts`, the 4 to 13 most recent posts a profile page shows.
* `post` returns `post`. `replies` returns `replies`, about 10 per post. `availableCount` is the post's reply count, and `partial: true` marks a list shorter than that count, as when the author hid replies.
* A profile or post that does not exist or is not public ends the task with `PAGE_UNAVAILABLE`. Only completed requests are charged.

## Related

* [Instagram](https://docs.querying.ai/engines/instagram.md)
* [YouTube](https://docs.querying.ai/engines/youtube.md)
* [Engine overview](https://docs.querying.ai/engines/overview.md)
* [Credits and limits](https://docs.querying.ai/concepts/credits-and-limits.md)


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