for AI agents
← All tools
threads · fetch · accountsolari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.

solari fetch threads account search

Find Threads accounts by name, live.

MCP tool
solari_fetch_threads_account_search
CLI
solari fetch threads account search
Access
solari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.Available on any SOLARI plan, including the trial. One credit per successful call.
Plans
Any paid plan or trial
Credit
1

Overview

Ask Threads itself for accounts matching a name or handle fragment. Hits are thin: handle, display name, verified badge, profile picture, and URL, in Threads' own order. Threads has no catalog, so this is its only account search; nothing is stored and no account_id is issued. Pick a hit, then fetch threads account reads its full profile.

When to use it — When you know a name or part of a handle but not the exact Threads handle.

What comes back — Up to limit candidates in Threads' order, and the fetch command to read the first one's profile.

Parameters

querystringrequired
Name or handle fragment, with or without @.≤ 100 chars
limitintegeroptional
How many hits, at most.≥ 1

Response

Response

querystring
The text the lookup ran on, without @.
itemsobject[]
Matching accounts, Threads' order.
totalinteger
Hits returned.
nextstring
Fetch command to read the first hit's profile. Only when there is a hit.

items[]

usernamestring
Handle, lowercase, without the @.
full_namestring | null
Display name.
is_verifiedboolean | null
Verified badge.
profile_pic_urlstring | null
Profile picture URL.
urlstring | null
Public profile URL.

Example

Request

$ solari fetch threads account search query=nike limit=1

Response · Long strings and repeated array entries are trimmed for readability.

{
  "query": "nike",
  "items": [
    {
      "username": "nike",
      "full_name": "Nike",
      "is_verified": true,
      "profile_pic_url": "https://scontent-gmp1-1.cdninstagram.com/v/t51.2885-19/467733497_2299328197118830_1129133478722126916_n.jpg?…",
      "url": "https://www.threads.com/@nike"
    }
  ],
  "total": 1,
  "next": "solari fetch threads account username=nike"
}

As an MCP call

{
  "name": "solari_fetch_threads_account_search",
  "arguments": {
    "query": "nike",
    "limit": 1
  }
}

Notes

  • Order and ranking are Threads' own, so the official account is not always first: check is_verified and full_name before choosing.
  • Nothing is stored and hits carry no account_id. fetch threads account with the chosen username reads follower count, bio, and bio links; fetch threads posts reads its posts.
  • Every call asks Threads live, takes a second or two, is not cached, and costs 1 credit. An empty items list means Threads matched nothing.

Related tools

Machine-readable: /docs/tools/fetch-threads-account-search.md