Scraping Bot Animated

scrapingbot

Threads Scraper API

Extract profile and post as structured JSON from public Threads targets. Queue a request, then retrieve the result with its responseId.

Get your API keyRead the documentation1,000 free credits per month, no card required.

Decide before you build

Endpoint
POST /scrape/data-scraper
Scrapers
threadsProfile threadsPost
Cost
30 credits / call
Free plan
1,000 credits / month
Call pattern
async, POST then GET
On failure
credits refunded
Response format
JSON
Concurrency
by plan tier

Launching a Social Media scrape costs 30 credits. Retrieving a pending result costs nothing; failed scrapes are refunded.

Try the Threads scraper on your own targetRun a request against a public target and inspect the JSON before you integrate.

Open the live test

What you get back

threadsProfile

Profile

Use threadsProfile to retrieve profile data from a public Threads target.

  • Required input: url
  • Optional input: posts_number
  • Structured JSON once the result is ready
  • Public data only; no account login is used
threadsPost

Single post

Use threadsPost to retrieve single post data from a public Threads target.

  • Required input: url
  • No optional input parameters
  • Structured JSON once the result is ready
  • Public data only; no account login is used

Call the Threads scraper

Send the scraper name with the input required by that scraper. The POST returns a responseId to poll for the final JSON.

Step 1Submit a threadsProfile request and keep the responseId returned by the API.
bash
# POST - queue a public social media scrape
curl -X POST "https://api.scraping-bot.io/scrape/data-scraper" \
  -u "yourUsername:yourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
  "scraper": "threadsProfile",
  "url": "https://example.com/public-page",
  "posts_number": 10
}'
Step 2Wait a few seconds, then retrieve the threadsProfile result with the responseId. Repeat the GET while the status is pending.
bash
# GET - retrieve the result after the POST returns a responseId
curl -G "https://api.scraping-bot.io/scrape/data-scraper-response" \
  -u "yourUsername:yourApiKey" \
  --data-urlencode "responseId=RESPONSE_ID" \
  --data-urlencode "scraper=threadsProfile"

Code example

Authenticate with your ScrapingBot username and API key, then poll until the queued result is ready.

const auth = "Basic " + Buffer.from(
  "yourUsername:yourApiKey",
).toString("base64");

const queued = await fetch("https://api.scraping-bot.io/scrape/data-scraper", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: auth },
  body: JSON.stringify({
  "scraper": "threadsProfile",
  "url": "https://example.com/public-page",
  "posts_number": 10
}),
});

const { responseId } = await queued.json();
let result;
do {
  await new Promise((resolve) => setTimeout(resolve, 5000));
  result = await fetch(
    "https://api.scraping-bot.io/scrape/data-scraper-response?" +
      new URLSearchParams({ responseId, scraper: "threadsProfile" }),
    { headers: { Authorization: auth } },
  ).then((response) => response.json());
} while (result.status === "pending");

Run this call in two minutesCreate an account, copy your API key, then use the example above.

Get your API key

Request parameters

ParameterTypeDefaultDescription
scraperstring—One of the scraper names supported by this endpoint.
urlstring—Public page URL, including https://.
posts_numberint10Optional for this scraper.

Response example

Example returned by the legacy Threads scraper documentation.

json
{
    "data": {
        "username": "threadsapp",
        "profile_picture": "https://scontent.cdninstagram.com/v/t51.2885-19/357635170_778931314240421_6964405388884023947_n.jpg?stp=dst-jpg_s150x150&_nc_ht=scontent.cdninstagram.com&_nc_cat=1&_nc_ohc=CVKtenaL0m0AX8jiK0m&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfBeNUC6jV7WC0eWUkm7f1ZjuTz-WQr8z3650Ak98LlaoA&oe=64BCEF19&_nc_sid=10d13b",
        "name": "Threads",
        "is_private": false,
        "is_verified": true,
        "biography": "Powered by Instagram. Say more ✨",
        "bio_links": [
            "https://about.instagram.com/blog/announcements/threads-instagram-text-feature",
            "https://www.instagram.com/threadsapp/"
        ],
        "followers": 1033842,
        "posts": [
            {
                "username": "threadsapp",
                "profile_picture": "https://scontent.cdninstagram.com/v/t51.2885-19/357635170_778931314240421_6964405388884023947_n.jpg?stp=dst-jpg_s150x150&_nc_ht=scontent.cdninstagram.com&_nc_cat=1&_nc_ohc=CVKtenaL0m0AX_H5ZEr&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfAzfDhp-rqJV5A3ixhR3kHKb-WBuunmPeKgkEOL2zbZqA&oe=64BCEF19&_nc_sid=10d13b",
                "is_verified": true,
                "caption": "ICYMI: We’re working toward making Threads compatible with ActivityPub, which means it would work with apps like Mastodon and WordPress. 

Think of it like email: You can write to anyone with an email address, because it’s a decentralized system. 📧 More here:",
                "replies": "578 replies",
                "likes": 5761,
                "timestamp": 1689704170
            },
            {
                "username": "threadsapp",
                "profile_picture": "https://scontent.cdninstagram.com/v/t51.2885-19/357635170_778931314240421_6964405388884023947_n.jpg?stp=dst-jpg_s150x150&_nc_ht=scontent.cdninstagram.com&_nc_cat=1&_nc_ohc=CVKtenaL0m0AX_H5ZEr&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfAzfDhp-rqJV5A3ixhR3kHKb-WBuunmPeKgkEOL2zbZqA&oe=64BCEF19&_nc_sid=10d13b",
                "is_verified": true,
                "caption": "So if you’re a creator with a public account here you’ll soon be able to reach new audiences with no added effort. 🔥 You’ll also have the option to take your content and move to other services like Mastodon at any time.

If you have a private account, you can approve people who want to follow you, similar to your experience on Instagram. ✔️",
                "replies": "196 replies",
                "likes": 1762,
                "timestamp": 1689704262
            }
        ]
    }
}

Credits, failures and limits

CaseCreditsNotes
Launch a scrape30 creditsConsumed when a result is ready.
Result not readyNot consumedThe API returns a pending status; retry after a few seconds.
Failed, blocked or timed-out scrapeRefundedCredits are returned for an unsuccessful request.

Threads API or Raw HTML scraper?

Threads APIRaw HTML scraper
Endpoint/scrape/data-scraper/scrape/raw-html
ReturnsProfile and post JSONRendered page HTML
FlowAsynchronous: POST then GETOne synchronous request
Starting cost30 credits1 credit
Use it whenYou need parsed Threads dataYou need your own extraction logic

Questions about the Threads API

Which Threads scraper names can I use?
This page supports threadsProfile and threadsPost. Send the exact name in the scraper field.
Why does the API return a responseId?
Social Media requests are asynchronous. The responseId lets you retrieve the result without holding the initial request open.
What if the result is still pending?
Wait a few seconds and repeat the GET request. A pending response does not consume credits.
Does this scraper access private account data?
No. It is intended for public pages and does not sign in to a social media account to access private data.

Source: ScrapingBot API documentation.

Other social media scrapers

Browse the Social Media category for the complete list of guides, or visit the ScrapingBot blog for implementation guides.

4.9
★★★★★
133 Google reviews

Trusted by developers and social media teams.
Customer reviews apply to ScrapingBot's service overall, not specifically to this scraper.

Start scraping Threads today

1,000 free credits every month. No card required, cancel anytime.