# 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-10-17.

- Page: https://socialtoai.com/platforms/threads/
- Last updated: 2026-10-17
- Last tested: 2026-10-17

## 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 | https://socialtoai.com/threads-search-api.md |
| `detail` | One post by ID or link: text, author, likes, comment count, views and publish time. | — | `threads.detail` | 2 | https://socialtoai.com/threads-detail-api.md |
| `user_profile` | One account: name, bio and followers. | — | `threads.user_profile` | 2 | https://socialtoai.com/threads-user-profile-api.md |
| `user_posts` | The recent posts of one account. | — | `threads.user_posts` | 2 | https://socialtoai.com/threads-user-posts-api.md |

Not offered on Threads: trending and comments.

## Example call

```bash
curl https://api.socialtoai.com/v1/search \
  -H "Authorization: Bearer $SOCIALTOAI_KEY" \
  -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 |

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

## Ready-made tools that read Threads

- [Brand buzz](https://socialtoai.com/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it
- [Account watch](https://socialtoai.com/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Creator profile](https://socialtoai.com/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.com/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.