↑ ↓ to move ↵ to open
Threads API reference

Threads Profile

threads.profile

Get a public profile from its handle: name, bio, followers, following and how many threads it has posted.

At a glance

Endpoint ID
threads.profile
Price
0.75 credits per call; failed calls are free
Runs for up to
45 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
threads__profile
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "threads.profile",  "input": {    "handle": "instagram"  }}'

Input

FieldTypeRequiredWhat it doesExample
handle string yes The profile's handle, such as instagram, with or without @. instagram

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "name": "Instagram",  "title": "Instagram (@instagram) • Threads, Say more",  "followers": 38400000,  "canonical_url": "https://www.threads.com/@instagram",  "description": "38.4M Followers • 1.5K Threads • Discover what's new on Instagram 🔎✨. See the latest conversations with @instagram.",  "following": 0,  "threads_count": 1500}

Fields

FieldTypeWhat it isExample
name string The account's name. Instagram
followers integer Followers, as Threads shows them. 38,400,000
following integer How many accounts it follows. 0
threads_count integer Threads posted, as Threads shows it. 1500
canonical_url string The profile's address. https://www.threads.com/@instagram
title string The page title Threads shows. Instagram (@instagram) • Threads, Say more
description string The page description Threads shows. 38.4M Followers • 1.5K Threads • Discover what's new on Instagr…

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Threads endpoints

Something missing or unclear? Ask the team that builds the Threads endpoints.