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