Threads

Meta 的文字社群平台。

貼文 ID：使用 shortcode（例如 DQt-ox3kdE4）或數字 ID
用戶查詢：所有用戶端點（個人檔案、貼文、回覆）使用用戶名稱
分頁：搜尋端點支援 cursor 進行分頁
固定結果數量：大多數列表端點搜尋回傳約 15 筆結果，用戶貼文/回覆回傳約 10 筆

貼文

`GET /threads/posts/:id` — 2 點數

依 shortcode 或 ID 取得單一貼文。一律回傳包含瀏覽次數的完整資料。

參數	類型	必填	預設	說明
`id`	string	是	—	Threads 貼文短代碼或數字 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());

回應


{
  "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 點數

批次取得多篇貼文。一律回傳包含瀏覽次數的完整資料。

參數	類型	必填	預設	說明
`ids`	string	是	—	以逗號分隔的貼文 ID 或短代碼

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());

回應


{
  "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 點數

取得 Threads 貼文的直接留言。從貼文永久連結的 SSR HTML 擷取已嵌入的留言。匿名存取每篇貼文可取回約 20 則頂層留言（Threads 的 SSR render 上限）；totalReplies 會顯示 Threads 實際的留言總數，hasMore 則標示是否被截斷。目前不支援翻頁取得更多留言。

參數	類型	必填	預設	說明
`max`	boolean	否	`false`	使用已登入模式以取得更完整資料

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());

回應


{
  "rootPost": {
    "id": "3870872187813562164",
    "code": "DW4Gb79kQc0",
    "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": "這是對原貼文的留言",
      "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
    }
    // ...更多項目
  ],
  "totalReplies": 476,
  "hasMore": true
}

`GET /threads/posts/search?q=xxx` — 3 點數（固定費率）

依關鍵字搜尋貼文。每次請求回傳約 15 篇貼文。

參數	類型	必填	預設	說明
`q`	string	是	—	搜尋關鍵字
`search_type`	string	否	`top`	排序方式：`top` 或 `recent`
`count`	integer	否	15	回傳貼文數量
`cursor`	string	否	—	分頁游標

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());

回應


{
  "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
  ]
}

用戶

`GET /threads/users/:username` — 2 點數

取得用戶個人檔案。

參數	類型	必填	預設	說明
`username`	string	是	—	Threads 用戶名稱

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());

回應


{
  "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 點數

取得用戶的貼文。

參數	類型	必填	預設	說明
`username`	string	是	—	Threads 用戶名稱
`count`	integer	否	10	回傳貼文數量

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());

回應


{
  "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 點數

取得用戶的回覆。

參數	類型	必填	預設	說明
`username`	string	是	—	Threads 用戶名稱
`count`	integer	否	10	回傳回覆數量

回應


{
  "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 點數

依用戶名稱或姓名搜尋用戶。

參數	類型	必填	預設	說明
`q`	string	是	—	搜尋關鍵字

回應


{
  "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
  ]
}

動態

`GET /threads/feed/public` — 2 點數

取得公開的「為你推薦」動態。

參數	類型	必填	預設	說明
`cursor`	string	否	—	分頁游標
`country`	string	否	`TW`	國家代碼

回應


{
  "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

貼文

GET /threads/posts/:id — 2 點數

cURL

Python

JavaScript

GET /threads/posts?ids=a,b,c — 每筆 2 點數

cURL

Python

JavaScript

GET /threads/posts/:id/replies — 3 點數

cURL

Python

JavaScript

GET /threads/posts/search?q=xxx — 3 點數（固定費率）

cURL

Python

JavaScript

用戶

GET /threads/users/:username — 2 點數

cURL

Python

JavaScript

GET /threads/users/:username/posts — 2 點數

cURL

Python

JavaScript

GET /threads/users/:username/replies — 2 點數

GET /threads/users/search?q=xxx — 2 點數

動態

GET /threads/feed/public — 2 點數

`GET /threads/posts/:id` — 2 點數

`GET /threads/posts?ids=a,b,c` — 每筆 2 點數

`GET /threads/posts/:id/replies` — 3 點數

`GET /threads/posts/search?q=xxx` — 3 點數（固定費率）

`GET /threads/users/:username` — 2 點數

`GET /threads/users/:username/posts` — 2 點數

`GET /threads/users/:username/replies` — 2 點數

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

`GET /threads/feed/public` — 2 點數