Threads

Meta’s text-based social platform.

Post IDs: Use the shortcode (e.g. DQt-ox3kdE4) or numeric ID
User lookup: Use username for all user endpoints (profile, posts, replies)
Pagination: Search endpoints support cursor for pagination
Fixed result counts: Most list endpoints return ~15 results for search, ~10 for user posts/replies

Posts

`GET /threads/posts/:id` — 2 credits

Get a single post by shortcode or ID. Always returns full data with views.

Param	Type	Required	Default	Description
`id`	string	Yes	—	Threads post shortcode or numeric ID

cURL


curl -H "x-api-key: sk_oms_xxx" \
  https://api.omniscrape.dev/threads/posts/DQt-ox3kdE4

Python


import requests
 
response = requests.get(
    "https://api.omniscrape.dev/threads/posts/DQt-ox3kdE4",
    headers={"x-api-key": "sk_oms_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch("https://api.omniscrape.dev/threads/posts/DQt-ox3kdE4", {
  headers: { "x-api-key": "sk_oms_xxx" },
});
console.log(await response.json());

Response


{
  "id": "3759936745132642616",
  "mediaId": "18062699315155466",
  "code": "DQt-ox3kdE4",
  "text": "Priscilla and I started CZI almost 10 years ago...",
  "user": {
    "id": "314216",
    "username": "zuck",
    "profilePic": "https://...",
    "isVerified": true
  },
  "media": [],
  "views": null,
  "stats": {
    "likes": 818,
    "replies": 927,
    "quotes": 16,
    "reposts": 112,
    "shares": 119
  },
  "createdAt": "2025-11-06T14:30:09.000Z",
  "replyTo": null,
  "threadChain": [],
  "isReply": false
}

`GET /threads/posts?ids=a,b,c` — 2 credits per item

Batch get multiple posts. Always returns full data with views.

Param	Type	Required	Default	Description
`ids`	string	Yes	—	Comma-separated post IDs or shortcodes

cURL


curl -H "x-api-key: sk_oms_xxx" \
  "https://api.omniscrape.dev/threads/posts?ids=DQt-ox3kdE4,DQEmdfkkSNE"

Python


import requests
 
response = requests.get(
    "https://api.omniscrape.dev/threads/posts?ids=DQt-ox3kdE4,DQEmdfkkSNE",
    headers={"x-api-key": "sk_oms_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.omniscrape.dev/threads/posts?ids=DQt-ox3kdE4,DQEmdfkkSNE",
  {
    headers: { "x-api-key": "sk_oms_xxx" },
  },
);
console.log(await response.json());

Response


{
  "posts": [
    {
      "id": "3759936745132642616",
      "mediaId": "18062699315155466",
      "code": "DQt-ox3kdE4",
      "text": "Priscilla and I started CZI almost 10 years ago...",
      "user": {
        "id": "314216",
        "username": "zuck",
        "profilePic": "https://...",
        "isVerified": true
      },
      "media": [],
      "views": 166996,
      "stats": {
        "likes": 818,
        "replies": 927,
        "quotes": 16,
        "reposts": 112,
        "shares": 119
      },
      "createdAt": "2025-11-06T14:30:09.000Z",
      "replyTo": null,
      "threadChain": [],
      "isReply": false
    }
    // ...more items
  ]
}

`GET /threads/posts/:id/replies` — 3 credits

Get direct replies to a Threads post. Extracts replies embedded in the post permalink SSR HTML. Anonymous access returns ~20 top-level replies per post (Threads’ SSR render limit); totalReplies reflects the true count reported by Threads and hasMore indicates truncation. Pagination beyond the first batch is not supported.

Param	Type	Required	Default	Description
`max`	boolean	No	`false`	Use authenticated mode for enhanced data

cURL


curl -H "x-api-key: sk_oms_xxx" \
  "https://api.omniscrape.dev/threads/posts/DW4Gb79kQc0/replies"

Python


import requests
 
response = requests.get(
    "https://api.omniscrape.dev/threads/posts/DW4Gb79kQc0/replies",
    headers={"x-api-key": "sk_oms_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.omniscrape.dev/threads/posts/DW4Gb79kQc0/replies",
  {
    headers: { "x-api-key": "sk_oms_xxx" },
  },
);
console.log(await response.json());

Response


{
  "rootPost": {
    "id": "3870872187813562164",
    "code": "DW4Gb79kQc0",
    "text": "Original post text...",
    "user": {
      "id": "314216",
      "username": "zuck",
      "profilePic": "https://...",
      "isVerified": true
    },
    "stats": { "likes": 2613, "replies": 476, "quotes": 55, "reposts": 189, "shares": 336 },
    "createdAt": "2026-04-09T14:00:00.000Z"
  },
  "replies": [
    {
      "id": "3870872993254359647",
      "code": "DW4Hqm0AMge",
      "text": "This is a reply to the original post",
      "user": {
        "id": "63125302142",
        "username": "justincookphoto",
        "profilePic": "https://...",
        "isVerified": false
      },
      "media": [],
      "stats": { "likes": 92, "replies": 5, "quotes": 0, "reposts": 0, "shares": 0 },
      "createdAt": "2026-04-09T15:00:00.000Z",
      "replyTo": null,
      "threadChain": [],
      "isReply": true
    }
    // ...more items
  ],
  "totalReplies": 476,
  "hasMore": true
}

`GET /threads/posts/search?q=xxx` — 3 credits (flat rate)

Search posts by keyword. Returns ~15 posts per request.

Param	Type	Required	Default	Description
`q`	string	Yes	—	Search keyword
`search_type`	string	No	`top`	Sort order: `top` or `recent`
`count`	integer	No	15	Number of posts to return
`cursor`	string	No	—	Pagination cursor

cURL


curl -H "x-api-key: sk_oms_xxx" \
  "https://api.omniscrape.dev/threads/posts/search?q=threads&search_type=recent"

Python


import requests
 
response = requests.get(
    "https://api.omniscrape.dev/threads/posts/search?q=threads&search_type=recent",
    headers={"x-api-key": "sk_oms_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.omniscrape.dev/threads/posts/search?q=threads&search_type=recent",
  {
    headers: { "x-api-key": "sk_oms_xxx" },
  },
);
console.log(await response.json());

Response


{
  "posts": [
    {
      "id": "3847614751430661572",
      "mediaId": "17913742854319868",
      "code": "DVleTsbk9XE",
      "text": "Artists! Show me your most recent artwork!...",
      "user": {
        "id": "63436967516",
        "username": "koshino.yoshihiro",
        "profilePic": "https://...",
        "isVerified": true
      },
      "media": [],
      "stats": {
        "likes": 41,
        "replies": 118,
        "quotes": 0,
        "reposts": 0,
        "shares": 0
      },
      "createdAt": "2026-03-07T13:50:42.000Z"
    }
    // ...more items
  ]
}

Users

`GET /threads/users/:username` — 2 credits

Get user profile.

Param	Type	Required	Default	Description
`username`	string	Yes	—	Threads username

cURL


curl -H "x-api-key: sk_oms_xxx" \
  https://api.omniscrape.dev/threads/users/zuck

Python


import requests
 
response = requests.get(
    "https://api.omniscrape.dev/threads/users/zuck",
    headers={"x-api-key": "sk_oms_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch("https://api.omniscrape.dev/threads/users/zuck", {
  headers: { "x-api-key": "sk_oms_xxx" },
});
console.log(await response.json());

Response


{
  "id": "314216",
  "username": "zuck",
  "fullName": "Mark Zuckerberg",
  "profilePic": "https://...",
  "bio": "I build stuff",
  "isVerified": true,
  "followerCount": 5439848,
  "followingCount": 0
}

`GET /threads/users/:username/posts` — 2 credits

Get a user’s posts.

Param	Type	Required	Default	Description
`username`	string	Yes	—	Threads username
`count`	integer	No	10	Number of posts to return

cURL


curl -H "x-api-key: sk_oms_xxx" \
  https://api.omniscrape.dev/threads/users/zuck/posts

Python


import requests
 
response = requests.get(
    "https://api.omniscrape.dev/threads/users/zuck/posts",
    headers={"x-api-key": "sk_oms_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.omniscrape.dev/threads/users/zuck/posts",
  {
    headers: { "x-api-key": "sk_oms_xxx" },
  },
);
console.log(await response.json());

Response


{
  "posts": [
    {
      "id": "3759936745132642616",
      "code": "DQt-ox3kdE4",
      "text": "Priscilla and I started CZI almost 10 years ago...",
      "user": {
        "id": "314216",
        "username": "zuck",
        "profilePic": "https://...",
        "isVerified": true
      },
      "stats": {
        "likes": 818,
        "replies": 927,
        "quotes": 16,
        "reposts": 112,
        "shares": 119
      },
      "hasMedia": false,
      "createdAt": "2025-11-06T14:30:09.000Z"
    }
    // ...more items
  ]
}

`GET /threads/users/:username/replies` — 2 credits

Get a user’s replies.

Param	Type	Required	Default	Description
`username`	string	Yes	—	Threads username
`count`	integer	No	10	Number of replies to return

Response


{
  "replies": [
    {
      "type": "others",
      "replyId": "3848726738042452746",
      "replyCode": "DVpbJOqkXsK",
      "replyText": "Congrats! This is wild...",
      "replyTimestamp": "2026-03-09T02:40:01.000Z",
      "stats": {
        "likes": 60,
        "replies": 12,
        "quotes": 0,
        "reposts": 0,
        "shares": 5
      },
      "replier": {
        "id": "314216",
        "username": "zuck",
        "profilePic": "https://...",
        "isVerified": true
      },
      "replyTo": {
        "postId": "3848622568860907884",
        "postCode": "DVpDdXjgXls",
        "postText": "Original post text...",
        "postUrl": "https://www.threads.com/@otheruser/post/DVpDdXjgXls",
        "author": {
          "id": "63215166896",
          "username": "otheruser",
          "profilePic": "https://...",
          "isVerified": true
        }
      }
    }
    // ...more items
  ]
}

`GET /threads/users/search?q=xxx` — 2 credits

Search users by username or name.

Param	Type	Required	Default	Description
`q`	string	Yes	—	Search query

Response


{
  "users": [
    {
      "id": "314216",
      "username": "zuck",
      "fullName": "Mark Zuckerberg",
      "profilePic": "https://...",
      "isVerified": null
    },
    {
      "id": "43015418666",
      "username": "zuckubus",
      "fullName": "Memes | Comedy | Entertainment",
      "profilePic": "https://...",
      "isVerified": null
    }
    // ...more items
  ]
}

Feed

`GET /threads/feed/public` — 2 credits

Get public For You feed.

Param	Type	Required	Default	Description
`cursor`	string	No	—	Pagination cursor
`country`	string	No	`TW`	Country code

Response


{
  "posts": [
    {
      "id": "3847150142294366101",
      "code": "DVj0qvdDJeV",
      "text": "Why they ain't got on no white gloves touching...",
      "user": {
        "id": "63446067958",
        "username": "candicebenbow",
        "profilePic": "https://...",
        "isVerified": true
      },
      "stats": {
        "likes": 42,
        "replies": 3,
        "reposts": 2,
        "quotes": 0,
        "shares": 0
      },
      "createdAt": "2026-03-06T22:27:36.000Z",
      "media": []
    }
    // ...more items
  ]
}

Threads

Posts

GET /threads/posts/:id — 2 credits

cURL

Python

JavaScript

GET /threads/posts?ids=a,b,c — 2 credits per item

cURL

Python

JavaScript

GET /threads/posts/:id/replies — 3 credits

cURL

Python

JavaScript

GET /threads/posts/search?q=xxx — 3 credits (flat rate)

cURL

Python

JavaScript

Users

GET /threads/users/:username — 2 credits

cURL

Python

JavaScript

GET /threads/users/:username/posts — 2 credits

cURL

Python

JavaScript

GET /threads/users/:username/replies — 2 credits

GET /threads/users/search?q=xxx — 2 credits

Feed

GET /threads/feed/public — 2 credits

`GET /threads/posts/:id` — 2 credits

`GET /threads/posts?ids=a,b,c` — 2 credits per item

`GET /threads/posts/:id/replies` — 3 credits

`GET /threads/posts/search?q=xxx` — 3 credits (flat rate)

`GET /threads/users/:username` — 2 credits

`GET /threads/users/:username/posts` — 2 credits

`GET /threads/users/:username/replies` — 2 credits

`GET /threads/users/search?q=xxx` — 2 credits

`GET /threads/feed/public` — 2 credits