Tham chiếu điểm cuối Threads | Tài liệu 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)

Đọc hồ sơ, bài đăng, câu trả lời, bài đăng lại, bình luận và kết quả tìm kiếm qua 12 điểm cuối Threads có xác thực.

Dùng tham số truy vấn GET, không có thân yêu cầu. Trường không rõ, trùng lặp hoặc không hợp lệ bị từ chối. Giữ ID dưới dạng chuỗi, kể cả giá trị vượt phạm vi số nguyên an toàn của JavaScript. Yêu cầu hết thời gian sau 60 giây và không được tự động thử lại.

Giá mặc định là $0.002 (2000 tín dụng) mỗi yêu cầu thành công, gồm cả mảng hoặc đối tượng rỗng thành công, không theo từng mục. Giá riêng của tài khoản được ưu tiên. Yêu cầu thượng nguồn thất bại giải phóng khoản giữ chỗ. Lỗi quyết toán trả lỗi mà không lặp lại yêu cầu thượng nguồn.

Bài đăng, bài đăng lại, câu trả lời của người dùng, bình luận bài đăng, tìm kiếm hàng đầu và tìm kiếm gần đây không hỗ trợ phân trang. Trường end_cursor được dành trước và không có tác dụng; không dùng next_cursor hoặc has_more để lấy thêm trang. Danh sách người dùng chỉ trả lô hiện có (khoảng 25 mục), không phải toàn bộ lịch sử. Không điểm cuối nào tự động lấy thêm dữ liệu.

web-fetch_user_info

Hồ sơ người dùng

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`username`	Có	`string`; Tên người dùng

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

Hồ sơ người dùng theo ID

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`user_id`	Có	`string`; ID người dùng dạng số; `^[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

Bài đăng người dùng

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`user_id`	Có	`string`; ID người dùng dạng số; `^[0-9]+$`
`end_cursor`	Không	`string`; Dành trước; không phân trang

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

Bài đăng lại của người dùng

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`user_id`	Có	`string`; ID người dùng dạng số; `^[0-9]+$`
`end_cursor`	Không	`string`; Dành trước; không phân trang

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

Câu trả lời của người dùng

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`user_id`	Có	`string`; ID người dùng dạng số; `^[0-9]+$`
`end_cursor`	Không	`string`; Dành trước; không phân trang

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

Bài đăng theo ID số

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`post_id`	Có	`string`; ID bài đăng dạng số; `^[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

Bài đăng theo shortcode hoặc URL

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Ít nhất một: post_id, url.

Trường	Bắt buộc	Hợp đồng
`post_id`	Không	`string`; Shortcode bài đăng
`url`	Không	`string`; URL bài đăng đầy đủ

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

Bình luận bài đăng

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`post_id`	Có	`string`; ID bài đăng dạng số; `^[0-9]+$`
`end_cursor`	Không	`string`; Dành trước; không phân trang

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

Tìm kiếm hàng đầu

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`query`	Có	`string`; Từ khóa tìm kiếm
`end_cursor`	Không	`string`; Dành trước; không phân trang

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

Tìm kiếm gần đây

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`query`	Có	`string`; Từ khóa tìm kiếm
`end_cursor`	Không	`string`; Dành trước; không phân trang

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

Tìm bài đăng

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`query`	Có	`string`; Từ khóa tìm kiếm

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

Tìm hồ sơ

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

Giá mỗi yêu cầu thành công: $0.002 (2000 tín dụng).

Trường	Bắt buộc	Hợp đồng
`query`	Có	`string`; Từ khóa tìm kiếm

bash

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

Phản hồi

Lớp bao JSON code/data gốc và độ chính xác số được giữ nguyên. Thành công yêu cầu code=200 và data không null. Lỗi nghiệp vụ HTTP 200 là thất bại. Cấu trúc phản hồi khác nhau theo điểm cuối; ví dụ này chỉ minh họa, không phải phản hồi trực tiếp.

json

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

Lỗi

HTTP 400: tham số không hợp lệ; 401: xác thực thất bại; 402: thiếu tín dụng; 403: truy cập bị từ chối; 405: phương thức không được hỗ trợ; 408: hủy; 429: giới hạn tốc độ; 5xx: lỗi dịch vụ hoặc thượng nguồn, gồm hết thời gian 504. Giữ X-Request-Id để chẩn đoán.

Nguồn

Đã đối chiếu với OpenAPI V5.3.2 chính thức và giá điểm cuối ngày 2026-10-31. Thao tác fetch_post_id_from_url chỉ có trong bảng giá bị loại vì không có trong OpenAPI.

TikHub · OpenAPI · Giá