Threads API

Meta 的文字社群平台。

貼文 ID：使用 shortcode（例如 DQt-ox3kdE4）或數字 ID
用戶查詢：所有用戶端點（個人檔案、貼文、回覆）使用用戶名稱
分頁：使用前一次回應中的 cursor 值來取得下一頁
固定結果數量：大多數列表端點搜尋回傳約 15 筆結果，用戶貼文/回覆回傳約 10 筆

貼文

`GET /threads/posts/:id` — 2 點數（`mode=full` 為 4 點數）

依 shortcode 或 ID 取得單一貼文。

參數	類型	必填	預設	說明
`id`	string	是	—	Threads 貼文短代碼或數字 ID
`mode`	string	否	—	`full`（包含瀏覽次數）

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/threads/posts/DQt-ox3kdE4

Python


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

JavaScript


const response = await fetch("https://api.bycrawl.com/threads/posts/DQt-ox3kdE4", {
  headers: { "x-api-key": "sk_byc_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 點數（`mode=full` 每筆 4 點數）

批次取得多篇貼文。支援相同的 mode 查詢參數。

參數	類型	必填	預設	說明
`ids`	string	是	—	以逗號分隔的貼文 ID 或短代碼
`mode`	string	否	—	`full`（包含瀏覽次數）

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/threads/posts?ids=DQt-ox3kdE4,DQEmdfkkSNE&mode=full"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/threads/posts?ids=DQt-ox3kdE4,DQEmdfkkSNE&mode=full",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/threads/posts?ids=DQt-ox3kdE4,DQEmdfkkSNE&mode=full",
  {
    headers: { "x-api-key": "sk_byc_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
  }
  // ...more items
]

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

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

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

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/threads/posts/search?q=threads&search_type=recent"

Python


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

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/threads/posts/search?q=threads&search_type=recent",
  {
    headers: { "x-api-key": "sk_byc_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
  ],
  "pageInfo": {
    "hasNextPage": false,
    "endCursor": null
  }
}

用戶

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

取得用戶個人檔案。

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

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/threads/users/zuck

Python


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

JavaScript


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

回應


{
  "id": "314216",
  "username": "zuck",
  "fullName": "Mark Zuckerberg",
  "profilePic": "https://...",
  "hdProfilePic": [
    { "width": 320, "height": 320, "url": "https://..." },
    { "width": 640, "height": 640, "url": "https://..." }
  ],
  "bio": "I build stuff",
  "isVerified": true,
  "followerCount": 5439848,
  "followingCount": 0
}

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

取得用戶的貼文。使用前一次回應中的 cursor 進行分頁。

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

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/threads/users/zuck/posts

Python


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

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/threads/users/zuck/posts",
  {
    headers: { "x-api-key": "sk_byc_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": [],
      "stats": {
        "likes": 818,
        "replies": 927,
        "quotes": 16,
        "reposts": 112,
        "shares": 119
      },
      "createdAt": "2025-11-06T14:30:09.000Z",
      "isReply": false
    }
    // ...more items
  ],
  "cursor": "eyJpZCI6IjM3NTk5MzY3NDUxMzI2NDI2MTYifQ==",
  "hasMore": true
}

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

取得用戶的回覆。

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

回應


{
  "replies": [
    {
      "id": "3847150142294366101",
      "code": "DVj0qvdDJeV",
      "text": "Reply content from the user...",
      "user": {
        "id": "314216",
        "username": "zuck",
        "profilePic": "https://...",
        "isVerified": true
      },
      "media": [],
      "stats": {
        "likes": 42,
        "replies": 3,
        "quotes": 0,
        "reposts": 2,
        "shares": 0
      },
      "createdAt": "2026-03-06T22:27:36.000Z",
      "isReply": true,
      "replyTo": {
        "id": "3847000000000000000",
        "username": "otheruser"
      }
    }
    // ...more items
  ],
  "cursor": "eyJpZCI6IjM4NDcxNTAxNDIyOTQzNjYxMDEifQ==",
  "hasMore": true
}

`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",
        "fullName": "Candice Marie Benbow",
        "profilePic": "https://...",
        "isVerified": true
      },
      "stats": {
        "likes": 42,
        "replies": 3,
        "reposts": 2,
        "quotes": 0
      },
      "createdAt": "2026-03-06T22:27:36.000Z",
      "media": [
        {
          "type": "image",
          "url": "https://..."
        }
      ]
    }
    // ...more items
  ],
  "pageInfo": {
    "hasNextPage": true,
    "endCursor": "GvYXhISXmf2v0-NqjpamyfuGoORq..."
  }
}

`GET /threads/feed` — 2 點數

取得個人化動態。需要認證標頭。

Threads API

貼文

GET /threads/posts/:id — 2 點數（mode=full 為 4 點數）

cURL

Python

JavaScript

GET /threads/posts?ids=a,b,c — 每筆 2 點數（mode=full 每筆 4 點數）

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/feed — 2 點數

`GET /threads/posts/:id` — 2 點數（`mode=full` 為 4 點數）

`GET /threads/posts?ids=a,b,c` — 每筆 2 點數（`mode=full` 每筆 4 點數）

`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 點數

`GET /threads/feed` — 2 點數