ScrapeCreators SOP

Appearance

Post ​

GET /v1/threads/post

Fetches a single Threads post by URL, returning the post's caption, like_count, view_counts, reshare_count, direct_reply_count, image_versions2, and taken_at. Also includes comments and related_posts arrays. Supports a trim option for lighter responses.

Authentication ​

All requests require the x-api-key header. Get your key at scrapecreators.com.

Query Parameters ​

NameTypeRequiredDescriptionExample
urlstringyesThe URL of the post to gethttps://www.threads.com/@trendspider/post/DIU8naHS6q_
trimbooleannoSet to true for a trimmed down version of the responsefalse

Example Request ​

curl ​

bash
curl 'https://api.scrapecreators.com/v1/threads/post?url=https://www.threads.com/@trendspider/post/DIU8naHS6q_' \
  -H 'x-api-key: $SCRAPECREATORS_API_KEY'

Node / TypeScript ​

js
const params = new URLSearchParams({ url: 'https://www.threads.com/@trendspider/post/DIU8naHS6q_' });
const res = await fetch(`https://api.scrapecreators.com/v1/threads/post?${params}`, {
  headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);

Python ​

python
import os, requests
r = requests.get(
    'https://api.scrapecreators.com/v1/threads/post',
    headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
    params={'url': 'https://www.threads.com/@trendspider/post/DIU8naHS6q_'},
)
r.raise_for_status()
print(r.json())

CLI ​

bash
scrapecreators threads post --help

Example Response ​

json
{
  "success": true,
  "post": {
    "id": "3656367813102434565_63055343223",
    "pk": "3656367813102434565",
    "caption": {
      "text": "Spoiler alert: We're testing a way for you to hide spoilers in your Threads posts.",
      "pk": "17978979272714446",
      "has_translation": null
    },
    "code": "DK-BydcJHkF",
    "like_count": 96439,
    "taken_at": 1750093031,
    "user": {
      "pk": "63055343223",
      "friendship_status": null,
      "profile_pic_url": "https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/452737457_1313286386312102_744138929735022550_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QEI0Na315cY5sOYUkhVVibfgPAW-ui7qHsdVtzXBXEOhzW7Bng-EMYZTcNDR7NhzDw&_nc_ohc=4jx-dLM0V7UQ7kNvwF5pEvj&_nc_gid=08CADhHYLnZPoVapLCtXQw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfMJZBcCbhMdKKqnrXmtnhF3bwCCjEU85Z3Ih0GWNi5t6A&oe=685A71CE&_nc_sid=10d13b",
      "username": "zuck",
      "id": "63055343223",
      "full_name": "Mark Zuckerberg",
      "transparency_label": null,
      "transparency_product": null,
      "transparency_product_enabled": false,
      "is_verified": true,
      "text_post_app_is_private": false,
      "has_onboarded_to_text_post_app": true
    }
  },
  "comments": [
    {
      "id": "3658534918151603488_74973899807",
      "pk": "3658534918151603488",
      "caption": {
        "text": "意味分からない",
        "pk": "18306832783208063",
        "has_translation": true
      },
      "code": "DLFuh_SygUg",
      "like_count": 0,
      "taken_at": 1750351370,
      "user": {
        "pk": "74973899807",
        "friendship_status": null,
        "profile_pic_url": "https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/491446152_17850244230449803_8764028655689505242_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QEI0Na315cY5sOYUkhVVibfgPAW-ui7qHsdVtzXBXEOhzW7Bng-EMYZTcNDR7NhzDw&_nc_ohc=04OF9jMRuJoQ7kNvwF4M8X7&_nc_gid=08CADhHYLnZPoVapLCtXQw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfOd6QqjNHAV2HNKm-I63jqf58-6kNsVTzATgKyd-iN3zw&oe=685A9A82&_nc_sid=10d13b",
        "username": "emimimi_0917",
        "id": "74973899807",
        "full_name": "青木恵美",
        "transparency_label": null,
        "transparency_product": null,
        "transparency_product_enabled": false,
        "is_verified": true,
        "text_post_app_is_private": false,
        "has_onboarded_to_text_post_app": true
      }
    }
  ],
  "relatedPosts": [
    {
      "id": "3658572865166656590_63453315755",
      "pk": "3658572865166656590",
      "caption": {
        "text": "Initial findings of investigation into overnight ground explosion of SpaceX Starship rocket in Texas point to failure of a Composite Overwrapped Pressure Vessel (COPV), a lightweight storage tank containing nitrogen under high pressure. 🖥️ X/Elon Musk",
        "pk": "18345028147091883",
        "has_translation": null
      },
      "code": "DLF3KMNJERO",
      "like_count": 15,
      "taken_at": 1750355893,

... (truncated)

Credits ​

Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.

Errors ​

StatusMeaningAction
200Success.Use the JSON payload.
400Invalid or missing parameter.Verify required parameters and value format.
401Missing or invalid x-api-key.Pass a valid API key in the header.
402Out of credits.Top up at scrapecreators.com or wait for plan reset.
404Resource not found or private.Confirm the handle, URL, or id and that the resource is public.
429Rate limited.Backoff and retry with exponential delay.
500Server error or upstream platform failure.Retry with backoff; report persistent errors to support.