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

Start for freeSign in to run
4 of 6actions available
From 2 creditsper call
Same formatas every other call

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
You send
platformquery+2 optional
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://api.socialtoai.com/v1/search \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -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
You send
platformid or url
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://api.socialtoai.com/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -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
You send
platformusername
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://api.socialtoai.com/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -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
You send
platformusername
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://api.socialtoai.com/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -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.

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

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": [],  "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": [],  "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
Brand buzzHow people feel about it on each platform, what comes up most, and the posts behind itfrom 16 creditsAccount watchWhat each one posted lately, and which posts beat its usual numbersfrom 9 creditsCreator profileTheir accounts on other platforms, the numbers on each, and how sure the match isfrom 14 creditsBulk link dataOne row per link with its numbers as they are now. Links that no longer work are markedfrom 1 credit per link

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.

The same calls work on 17 more.

All platforms and prices
TikTokInstagramXRedditYouTubeFacebookLinkedInTelegramPinterestXiaohongshuDouyinWeiboWeChat ArticlesBilibiliZhihuKuaishouWeChat ChannelsMeta Ad LibraryGoogle Ads Transparency

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

Start for freeDocs

100 credits on sign-up, no card needed