Threads 介面參考 | API 文件

# Threads endpoint reference

Read profiles, posts, replies, reposts, comments and search results through 12 authenticated Threads endpoints.

Use GET query parameters without a request body. Unknown, duplicate or invalid fields are rejected. Keep IDs as strings, including values beyond the JavaScript safe integer range. Requests time out after 60 seconds and are not automatically retried.

The default price is $0.002 (2000 credits) per successful request, including successful empty arrays or objects, not per item. Account-specific prices take precedence. Failed upstream requests release the reservation. Settlement errors return an error without repeating the upstream request.

User posts, reposts, replies, post comments, top search and recent search do not support pagination. Their end_cursor field is reserved and has no effect; do not use next_cursor or has_more to fetch further pages. User lists return only the available batch (about 25 items), not full history. No endpoint automatically retrieves more data.

### web-fetch_user_info

User profile

`GET https://api.apihop.ai/v1/threads/web/users/profile`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `username` | Yes | `string`; Username |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=jlo"
```

### web-fetch_user_info_by_id

User profile by ID

`GET https://api.apihop.ai/v1/threads/web/users/profile/by-id`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/profile/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=67027868801"
```

### web-fetch_user_posts

User posts

`GET https://api.apihop.ai/v1/threads/web/users/posts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_user_reposts

User reposts

`GET https://api.apihop.ai/v1/threads/web/users/reposts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/reposts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_user_replies

User replies

`GET https://api.apihop.ai/v1/threads/web/users/replies`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `user_id` | Yes | `string`; Numeric user ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/users/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"
```

### web-fetch_post_detail

Post by numeric ID

`GET https://api.apihop.ai/v1/threads/web/posts/by-id`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | Yes | `string`; Numeric post ID; `^[0-9]+$` |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3349029093483693129"
```

### web-fetch_post_detail_v2

Post by shortcode or URL

`GET https://api.apihop.ai/v1/threads/web/posts/detail`

Price per successful request: **$0.002** (2000 credits).

At least one: `post_id`, `url`.

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | No | `string`; Post shortcode |
| `url` | No | `string`; Full post URL |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"
```

### web-fetch_post_comments

Post comments

`GET https://api.apihop.ai/v1/threads/web/posts/comments`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | Yes | `string`; Numeric post ID; `^[0-9]+$` |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3390920896561588969"
```

### web-search_top

Top search

`GET https://api.apihop.ai/v1/threads/web/search/top`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/top" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_recent

Recent search

`GET https://api.apihop.ai/v1/threads/web/search/recent`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |
| `end_cursor` | No | `string`; Reserved; no pagination |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/recent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_posts

Post search

`GET https://api.apihop.ai/v1/threads/web/search/posts`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"
```

### web-search_profiles

Profile search

`GET https://api.apihop.ai/v1/threads/web/search/profiles`

Price per successful request: **$0.002** (2000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `query` | Yes | `string`; Search terms |

```bash
curl --get "https://api.apihop.ai/v1/threads/web/search/profiles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=mark"
```

## Responses

The native JSON code/data envelope and numeric precision are preserved. Success requires code=200 and non-null data. An HTTP 200 business error is a failure. Response shapes vary by endpoint; this example is illustrative, not a live response.

```json
{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}
```

## Errors

HTTP 400: invalid parameters; 401: authentication failure; 402: insufficient credit; 403: access denied; 405: unsupported method; 408: cancellation; 429: rate limit; 5xx: service or upstream failure, including 504 timeout. Keep X-Request-Id for diagnosis.

## Sources

Checked against official OpenAPI V5.3.2 and endpoint prices on 2026-10-31. The price-only fetch_post_id_from_url operation is excluded because it is absent from OpenAPI.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

透過 12 個需要驗證的 Threads 介面查詢使用者資料、貼文、回覆、轉發、留言及搜尋結果。

使用 GET 查詢參數，不接受請求主體。未知、重複或無效欄位會遭拒絕。ID 須保留為字串，包括超出 JavaScript 安全整數範圍的值。請求逾時為 60 秒，不會自動重試。

預設依每次成功請求 $0.002（2000 credits）計費，包括成功傳回的空陣列或空物件，不依筆數計費。帳戶專屬價格優先。上游失敗會釋放預扣；結算失敗傳回錯誤，不會再次呼叫上游。

使用者貼文、轉發、回覆、貼文留言、熱門搜尋及最新搜尋不支援分頁。end_cursor 是無效的保留欄位，請勿依 next_cursor 或 has_more 請求後續頁。使用者清單僅傳回目前可得的一批資料（約 25 筆），並非完整歷史。所有介面均不會自動追加擷取。

web-fetch_user_info

使用者資料

GET https://api.apihop.ai/v1/threads/web/users/profile

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`username`	是	`string`; 使用者名稱

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=jlo"

web-fetch_user_info_by_id

依 ID 查詢使用者資料

GET https://api.apihop.ai/v1/threads/web/users/profile/by-id

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`user_id`	是	`string`; 純數字使用者 ID; `^[0-9]+$`

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/profile/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=67027868801"

web-fetch_user_posts

使用者貼文

GET https://api.apihop.ai/v1/threads/web/users/posts

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`user_id`	是	`string`; 純數字使用者 ID; `^[0-9]+$`
`end_cursor`	否	`string`; 保留欄位，不支援分頁

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_user_reposts

使用者轉發

GET https://api.apihop.ai/v1/threads/web/users/reposts

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`user_id`	是	`string`; 純數字使用者 ID; `^[0-9]+$`
`end_cursor`	否	`string`; 保留欄位，不支援分頁

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/reposts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_user_replies

使用者回覆

GET https://api.apihop.ai/v1/threads/web/users/replies

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`user_id`	是	`string`; 純數字使用者 ID; `^[0-9]+$`
`end_cursor`	否	`string`; 保留欄位，不支援分頁

bash

curl --get "https://api.apihop.ai/v1/threads/web/users/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=63625256886"

web-fetch_post_detail

依數字 ID 查詢貼文

GET https://api.apihop.ai/v1/threads/web/posts/by-id

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`post_id`	是	`string`; 純數字貼文 ID; `^[0-9]+$`

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3349029093483693129"

web-fetch_post_detail_v2

依短代碼或 URL 查詢貼文

GET https://api.apihop.ai/v1/threads/web/posts/detail

每次成功請求價格: $0.002 (2000 credits).

至少提供一個: post_id, url.

欄位	必填	約束
`post_id`	否	`string`; 貼文短代碼
`url`	否	`string`; 完整貼文 URL

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"

web-fetch_post_comments

貼文留言

GET https://api.apihop.ai/v1/threads/web/posts/comments

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`post_id`	是	`string`; 純數字貼文 ID; `^[0-9]+$`
`end_cursor`	否	`string`; 保留欄位，不支援分頁

bash

curl --get "https://api.apihop.ai/v1/threads/web/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3390920896561588969"

web-search_top

熱門搜尋

GET https://api.apihop.ai/v1/threads/web/search/top

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`query`	是	`string`; 搜尋關鍵字
`end_cursor`	否	`string`; 保留欄位，不支援分頁

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/top" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"

web-search_recent

web-search_posts

貼文搜尋

GET https://api.apihop.ai/v1/threads/web/search/posts

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`query`	是	`string`; 搜尋關鍵字

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=bitcoin"

web-search_profiles

使用者搜尋

GET https://api.apihop.ai/v1/threads/web/search/profiles

每次成功請求價格: $0.002 (2000 credits).

欄位	必填	約束
`query`	是	`string`; 搜尋關鍵字

bash

curl --get "https://api.apihop.ai/v1/threads/web/search/profiles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=mark"

回應

保留原始 JSON code/data 結構及數字精度。成功要求 code=200 且 data 非 null。HTTP 200 中的業務錯誤仍視為失敗。各介面回應結構不同；以下為說明性範例，並非即時回應。

json

{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}

錯誤

HTTP 400：參數錯誤；401：驗證失敗；402：餘額不足；403：無存取權限；405：不支援的方法；408：請求取消；429：速率限制；5xx：服務或上游錯誤，其中 504 表示逾時。排查時請保留 X-Request-Id。

來源

於 2026-10-31 核對官方 OpenAPI V5.3.2 與端點價格。僅出現在價目表中的 fetch_post_id_from_url 不在 OpenAPI 中，因此不納入接入範圍。

TikHub · OpenAPI · Prices