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

solari fetch threads account

One Threads account's profile, read live.

MCP tool
solari_fetch_threads_account
CLI
solari fetch threads account
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

Read one Threads account's profile by exact username: display name, bio, follower count, verified and private flags, bio links, and profile picture. Threads is fetch-only in SOLARI, so this call is the profile reader: there is no catalog or insight step. A handle SOLARI has never seen is collected live, which takes 5 to 30 seconds; within an hour the stored copy is reused unless refresh=true.

When to use it — When you have an exact Threads handle and want its profile. If you only know a name, run fetch threads account search first.

What comes back — The profile, when it was collected, and the fetch command to read its posts.

Parameters

usernamestringrequired
Threads username, with or without @.≤ 64 chars
refreshbooleanoptional
Collect again even if a copy from the last hour exists.

Response

Response

accountobject
The profile.
collected_attimestamp | null
When this copy was collected.
fetched_on_demandboolean
true if this call collected it live.
staleboolean
true if live collection failed and an older copy is returned. collected_at says how old.
notestring | null
Caveat, when there is one.
nextstring
Fetch command to read its posts.

account

account_iduuid
Threads account id. Not interchangeable with Instagram or TikTok.
usernamestring
Handle, lowercase, without the @.
full_namestring | null
Display name.
biographystring | null
Bio text.
follower_countinteger | null
Followers at collection time.
is_verifiedboolean | null
Verified badge.
is_privateboolean | null
Private account. Its posts come back empty.
bio_linksstring[]
Links listed in the bio.
profile_pic_urlstring | null
Profile picture URL, largest size available.
urlstring | null
Public profile URL.

Example

Request

$ solari fetch threads account username=zuck

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

{
  "account": {
    "account_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d5e",
    "username": "zuck",
    "full_name": "Mark Zuckerberg",
    "biography": "Mostly superintelligence and MMA takes",
    "follower_count": 5745085,
    "is_verified": true,
    "is_private": false,
    "bio_links": [],
    "profile_pic_url": "https://scontent-gmp1-1.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?…",
    "url": "https://www.threads.com/@zuck"
  },
  "collected_at": "2026-09-28T09:13:55Z",
  "fetched_on_demand": true,
  "stale": false,
  "note": null,
  "next": "solari fetch threads posts username=zuck"
}

As an MCP call

{
  "name": "solari_fetch_threads_account",
  "arguments": {
    "username": "zuck"
  }
}

Notes

  • Threads is fetch-only. There is no catalog or insight step: call this directly with the handle and read the response. To find a handle from a name, use fetch threads account search.
  • A first collection takes 5 to 30 seconds (fetched_on_demand=true). Repeat calls within an hour return the stored copy unless refresh=true.
  • stale=true means the live collection failed and an older copy came back. collected_at says how old it is.
  • Media URLs right after a collection may be temporary. Read them promptly.
  • A handle with no Threads profile is an error, not an empty result. Failed calls cost nothing.

Related tools

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