---
title: "Threads API: Search Posts, No App Review · SocialToAI"
canonical: https://socialtoai.app/platforms/threads/
updated: 2026-10-17
---

# Threads API

The Threads API lets you search posts and read post details, account profiles and an account's posts, with no Threads account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Threads does not give the author's follower count with a post, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.

- Page: https://socialtoai.app/platforms/threads/
- Last updated: 2026-10-17
- Last tested: 2026-11-19

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `search` | Find posts by keyword: text, author, likes, comment count and publish time. | — | `threads.search` | 2 | [Threads Search API](https://socialtoai.app/threads-search-api.md) |
| `detail` | One post by ID or link: text, author, likes, comment count, views and publish time. | — | `threads.detail` | 2 | [Threads Detail API](https://socialtoai.app/threads-detail-api.md) |
| `user_profile` | One account: name, bio and followers. | — | `threads.user_profile` | 2 | [Threads User Profile API](https://socialtoai.app/threads-user-profile-api.md) |
| `user_posts` | The recent posts of one account. | — | `threads.user_posts` | 2 | [Threads User Posts API](https://socialtoai.app/threads-user-posts-api.md) |

Not offered on Threads: trending and comments.

Compared with X: Threads posts also give shares but do not give author followers or saves; its accounts do not give following or posts.

Lighter for your AI: across 4 interfaces measured on the same recorded data, the platform's raw JSON is about 349,990 tokens and SocialToAI's answers about 19,992, 94% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
curl https://socialtoai.app/v1/search \
  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "threads",
    "query": "nasa"
  }'
```

## Fields Threads cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `title` | search, detail, user_posts |
| `author.followers` | search, detail, user_posts |
| `metrics.collects` | search, detail, user_posts |
| `metrics.views` | search, user_posts |
| `following` | user_profile |
| `posts_count` | user_profile |
| `author.name` | user_posts |

## What a whole job costs

| The job | How it adds up | Credits | About |
| --- | --- | --- | --- |
| Watch 1 Threads account daily, at most a month | 12 credits × 31 days | 372 credits | about $1.24 |

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

## Ask in your AI

- Which is bigger on Threads this week: home coffee or matcha? → search, search: 4 credits

- How big is this Threads account, and what has it posted lately? → user_profile, user_posts: 4 credits

- Look up this Threads account and tell me who it is. → user_profile: 2 credits

[Threads MCP Server](https://socialtoai.app/mcp/threads.md)

## Ready-made tools that read Threads

- [Brand buzz](https://socialtoai.app/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it
- [Account snapshot](https://socialtoai.app/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Creator profile](https://socialtoai.app/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.app/tools/batch-stats.md): One row per link with its numbers as they are now. Links that no longer work are marked

## Official API

The Threads API mainly serves users who authorise the app. It can search public posts by keyword once the app is approved for the keyword-search permission (before that, only the user's own posts), and public-profile lookup beyond Meta's official accounts also needs approval.

Source: [Threads's developer documentation](https://developers.facebook.com/docs/threads/keyword-search), checked 2026-10-17.

1,000 posts here: about 50 `threads.search` calls (typically 20 a page), 100 credits, $0.33 at the first pack. [Estimate your cost](https://socialtoai.app/free-tools/api-cost-estimator.md)

[Threads official API: access, prices and limits](https://socialtoai.app/does-threads-have-an-api.md)

- [Threads MCP server](https://socialtoai.app/mcp/threads.md): Let your AI read Threads.
