SocialToAIStart freeConsole

Threads API

Posts, accounts.

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.

4 of 6actions available
From 2 creditsper call
94% fewer tokensfor your AI than the raw JSON (4 interfaces measured)

Last tested: Last updated:

POST/v1/search200 OK2 credits
platform: "threads" · query: "nasa"
@…·
likes 43,152comments 3,630shares 1,775collects nullviews nullreposts 3,369
Always null here:titleauthor.followersmetrics.collectsmetrics.views
pageNext pagecursor
billingThis call2 credits
Sample data1 of the 19 items recorded

4 actions.
One response format.

Open a row to see its request. Its full parameters and response fields are on its own page.

ActionsCredits per call
SearchFind posts by keyword: text, author, likes, comment count and publish time./v1/search2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
You send
platformquery+2 optional
Threads Search API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
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"  }'
POST /v1/searchYour key goes in the Authorization header
DetailOne post by ID or link: text, author, likes, comment count, views and publish time./v1/detail2 credits≈ $0.0067
You send
platformid or url
Threads Detail API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "threads",    "id": "Dc3vb5DES3i"  }'
POST /v1/detailYour key goes in the Authorization header
User ProfileOne account: name, bio and followers./v1/user_profile2 credits≈ $0.0067
You send
platformusername
Threads User Profile API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "threads",    "username": "nasa"  }'
POST /v1/user_profileYour key goes in the Authorization header
User PostsThe recent posts of one account./v1/user_posts2 credits≈ $0.0067$0.23 per 1,000 (up to 30 a page)
You send
platformusername
Threads User Posts API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "threads",    "username": "nasa"  }'
POST /v1/user_postsYour key goes in the Authorization header

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.

What a whole job costs.

The jobHow it adds upCreditsAbout
Watch 1 Threads account daily, at most a month12 credits × 31 days372 creditsabout $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.

Or skip the parameters.
Just ask.

Connect SocialToAI once over MCP. Your AI picks the calls, and you see what each one cost.

You ask01

Which is bigger on Threads this week: home coffee or matcha?

Your AI calls
  • search“home coffee”2 credits
  • search“matcha”2 credits
Total4 credits
You ask02

How big is this Threads account, and what has it posted lately?

Your AI calls
  • user_profilethe account you named2 credits
  • user_postsits latest page2 credits
Total4 credits
You ask03

Look up this Threads account and tell me who it is.

Your AI calls
  • user_profilethe account you named2 credits
Total2 credits

Threads MCP Server

Same shape on every platform.
Learn it once.

A Threads post and a Xiaohongshu note come back with the same field names. What a platform cannot give comes back as null.

Threadsdetail · 2 credits
{  "platform": "threads",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "text",  "title": null,  "text": "…",  "published_at": "2026-09-04T15:46:28.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": true,    "followers": null  },  "metrics": {    "likes": 1466,    "comments": 43,    "shares": 9,    "collects": null,    "views": 37509,    "reposts": 111  },  "images": [],  "hashtags": ["…"],  "is_pinned": false}
Null on Threads:titleauthor.followersmetrics.collects
Xiaohongshudetail · 12 credits
{  "platform": "xiaohongshu",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "image",  "title": "…",  "text": "…",  "published_at": "2026-10-09T01:00:34.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": null,    "followers": null  },  "metrics": {    "likes": 927,    "comments": 122,    "shares": 256,    "collects": 59,    "views": null,    "reposts": null  },  "images": ["https://example.com/…", "https://example.com/…"],  "hashtags": ["…", "…"],  "is_pinned": false}
Null on Xiaohongshu:author.verifiedauthor.followersmetrics.viewsmetrics.reposts
Sample dataThe fields are always there; only the values differ.

4 tools read Threads.

All tools

Does Threads have an 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, 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

Threads official API: access, prices and limits

The same calls work on 17 more.

All platforms and prices

Your AI is one URL away
from all of social media.

100 credits on sign-up, no card needed