Spiral gives your agent every tool with one account. Browse the tools →

Hermes · Social Media

How to Use Threads Profile in Hermes

Fetch a Threads account's public bio, follower count, profile image, links, and verification status. Use it to compare brand profiles, prepare publisher briefs, or check profile changes; posts come from a separate endpoint.

Prompts to try with Threads Profile in Hermes

Copy an example into Hermes, or ask in your own words.

Every Monday, use Threads public profile for @sportsillustrated and report its follower count and the change since the previous run.

Threads ProfileHermes
Try asking
  • Each morning, use Threads public profile for @netflix and notify me when its bio or linked destinations differ from the previous run.

  • Every Friday, use Threads public profile for @nasa and @natgeo and produce a table of follower counts and weekly changes.

  • Once a week, use Threads public profile for @duolingo and report any changes to its display name, bio, or verification status.

  • Every Monday, use Threads public profile for @sportsillustrated and @natgeo and summarize additions or removals in their bio links since the previous run.

How to set up Threads Profile in Hermes

Pick the way that suits you. Each takes about two minutes.

Use the Spiral skill

  1. Send Hermes this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Threads Profile

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "scrapecreators",
        "model": "scrapecreators/threads-profile",
        "input": {
          "handle": "trendspider"
        }
      }'

Then paste one of the prompts above: Hermes finds Threads Profile on Spiral, shows the price and runs it.

Threads Profile providers and prices

Spiral runs Threads Profile through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Threads · Profile
scrapecreators/threads-profile

Settings you can ask for

Ask Hermes for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Cache max age1d, 3d, 7d, 14d, or 30d

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details.

Every API field of Threads · Profile is on its tool page: open its card above.

What can you do with Threads Profile in Hermes?

Produce a weekly report of follower-count changes for selected public Threads business accounts. A scheduled agent can also compare bios and bio links between runs and flag edits for review.

Compare publisher profiles

Compare selected public publishers by follower count, bio wording, verification status, and linked destinations before preparing a partnership brief.

Review brand positioning

Read public brand bios side by side to identify differences in how each business describes its products and audience.

Audit campaign links

Check the bio links on a brand's Threads profile against the destinations planned for a campaign.

Build a publisher directory

Populate directory entries for selected public media accounts with display names, bios, profile images, and bio links.

Measure audience changes

Save repeated follower-count snapshots for public business accounts and calculate changes between your own observations.

Review profile changes

Compare successive snapshots of public brand bios, display names, and links to flag edits for a communications team.

Questions about Threads Profile in Hermes

Can Hermes use Threads Profile?

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Threads Profile like any built-in tool.

How much does Threads Profile cost in Hermes?

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

Do I need a ScrapeCreators account to use Threads Profile in Hermes?

No. Spiral runs Threads Profile on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Threads Profile in Hermes?

About two minutes: add the server and sign in, then check it.

Does Hermes wait while Threads Profile runs?

Threads Profile runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

What public Threads data does this return?

It retrieves public profile information such as the username, bio, profile image, and follower count. The documented response also includes bio links and verification status.

How fresh is the profile data?

ScrapeCreators says live requests fetch the latest profile information available from Threads. A cached response contains data from an earlier scrape.

Does the profile response include posts?

ScrapeCreators documents profile information and public posts under separate endpoints. Use the profile response for account details; retrieving post content requires its posts endpoint.

Can the response identify a private Threads profile?

The documented response includes a Threads privacy flag. That flag describes the profile's privacy setting; the endpoint's stated scope is public profile data.

Can I redistribute the returned profile data?

ScrapeCreators permits redistribution, repackaging, and processing output with third-party AI providers. Its terms also make you responsible for complying with the accessed website's terms, policies, and applicable laws.

Get started

Start using Threads Profile in Hermes

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Hermes:

Set up Hermes

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options