for agents
← All tools
threads · fetch · accountsolari:read

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:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
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. 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.default 101–20

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, and is not cached. An empty items list means Threads matched nothing.

Related tools

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