for agents
← All tools
threads · fetchsolari:read

solari fetch threads account

One Threads account's profile, read live.

MCP tool
solari_fetch_threads_account
CLI
solari fetch threads account
Access
solari:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
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. 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

  • 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