Threads API

Four endpoints under /v1/threads/* (threads.com and threads.net URLs are both accepted as input). All are GET, authenticated with Authorization: Bearer sk_live_..., and return the standard { data, meta?, request_id } envelope. Coverage here is narrower than the other platforms: Threads is text-first, so stats and search carry the full post text with no transcript step, but reply threads and post transcripts are planned for v2. Threads does not publish view counts for most posts, so views is omitted from responses.

`GET /v1/threads/stats`

Engagement stats and text for a single Threads post: likes, replies, reposts, quotes, media, and author.

Availability: Threads does not publish view counts for most posts, so `views` is omitted from responses. Reply threads and post transcripts are planned for v2.

Credits: 3 per post · Caching: Age-aware cache (15 min - 7 days)

Parameters

Name		Description
`url`	required	Public Threads content URL.
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/threads/stats?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FC2isac0P7c7" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "threads",
    "entity_id": "C2isac0P7c7",
    "url": "https://www.threads.com/@zuck/post/C2isac0P7c7",
    "author": {
      "handle": "zuck",
      "name": "Example Creator"
    },
    "posted_at": "2026-06-30T14:05:00Z",
    "text": "Shipped the thing. Six months of nobody using it, then one good week.",
    "metrics": {
      "likes": 88410,
      "replies": 2314,
      "reposts": 1290,
      "quotes": 214
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

`GET /v1/threads/profile`

Public profile for a Threads account: follower count, bio, verification status, and profile link.

Credits: 4 per profile · Caching: Cached 12 hours

Parameters

Name		Description
`handle`	required	Public Threads handle (without @).
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/threads/profile?handle=zuck" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "threads",
    "handle": "zuck",
    "name": "Example Creator",
    "bio": "Notes on building in public. Links in profile.",
    "verified": true,
    "metrics": {
      "followers": 2450318
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

`GET /v1/threads/posts`

Recent public posts from a Threads account, newest first.

Availability: Threads does not publish view counts for most posts, so `views` is omitted from responses. Reply threads and post transcripts are planned for v2.

Credits: 3 per post · Caching: Cached 3 hours (page 1: 1 hour) · Paginated (cursor/limit)

Parameters

Name		Description
`handle`	required	Public Threads handle (without @).
`limit`	optional	Items per page (default 20, max 50 sync; larger via async jobs).
`cursor`	optional	Opaque cursor from the previous page's meta.cursor.
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/threads/posts?handle=zuck" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "C2isac0P7c7",
      "url": "https://www.threads.com/@zuck/post/C2isac0P7c7",
      "text": "Shipping notes: response times are down 40% after this week's cache work.",
      "posted_at": "2026-07-07T09:40:00Z",
      "metrics": {
        "likes": 88410,
        "replies": 2314,
        "reposts": 1290,
        "quotes": 214
      }
    },
    {
      "id": "C2isac0P7c71",
      "url": "https://www.threads.com/@zuck/post/C2isac0P7c7",
      "text": "Shipping notes: response times are down 40% after this week's cache work.",
      "posted_at": "2026-07-07T09:40:00Z",
      "metrics": {
        "likes": 88410,
        "replies": 2314,
        "reposts": 1290,
        "quotes": 214
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "item": "post"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

`GET /v1/threads/search`

Public Threads posts matching a keyword or hashtag.

Availability: Threads does not publish view counts for most posts, so `views` is omitted from responses. Reply threads and post transcripts are planned for v2.

Credits: 4 per result · Caching: Age-aware cache (15 min - 7 days) · Paginated (cursor/limit)

Parameters

Name		Description
`query`	required	Search keywords.
`limit`	optional	Items per page (default 20, max 50 sync; larger via async jobs).
`cursor`	optional	Opaque cursor from the previous page's meta.cursor.
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/threads/search?query=coffee%20brewing" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "C2isac0P7c7",
      "url": "https://www.threads.com/@zuck/post/C2isac0P7c7",
      "text": "Everyone building ai agents keeps rediscovering the same three problems.",
      "posted_at": "2026-07-07T09:40:00Z",
      "metrics": {
        "likes": 88410,
        "replies": 2314,
        "reposts": 1290,
        "quotes": 214
      }
    },
    {
      "id": "C2isac0P7c71",
      "url": "https://www.threads.com/@zuck/post/C2isac0P7c7",
      "text": "Everyone building ai agents keeps rediscovering the same three problems.",
      "posted_at": "2026-07-07T09:40:00Z",
      "metrics": {
        "likes": 88410,
        "replies": 2314,
        "reposts": 1290,
        "quotes": 214
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "item": "result"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}