Referensi endpoint Threads | Dokumentasi 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)

Baca profil, postingan, balasan, postingan ulang, komentar, dan hasil pencarian melalui 12 endpoint Threads yang memerlukan autentikasi.

Gunakan parameter kueri GET tanpa isi permintaan. Kolom yang tidak dikenal, duplikat, atau tidak valid ditolak. Simpan ID sebagai string, termasuk nilai di luar rentang bilangan bulat aman JavaScript. Permintaan melewati batas waktu setelah 60 detik dan tidak dicoba ulang secara otomatis.

Harga bawaan adalah $0.002 (2000 credits) per permintaan yang berhasil, termasuk array atau objek kosong yang berhasil, bukan per item. Harga khusus akun berlaku lebih dahulu. Permintaan hulu yang gagal melepaskan cadangan. Kesalahan penyelesaian biaya mengembalikan kesalahan tanpa mengulangi permintaan hulu.

Postingan pengguna, postingan ulang, balasan, komentar postingan, pencarian terpopuler, dan pencarian terbaru tidak mendukung paginasi. Kolom end_cursor dicadangkan dan tidak berpengaruh; jangan menggunakan next_cursor atau has_more untuk mengambil halaman berikutnya. Daftar pengguna hanya mengembalikan kelompok data yang tersedia (sekitar 25 item), bukan seluruh riwayat. Tidak ada endpoint yang mengambil data tambahan secara otomatis.

web-fetch_user_info

Profil pengguna

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`username`	Ya	`string`; Nama pengguna

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

Profil pengguna berdasarkan ID

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`user_id`	Ya	`string`; ID pengguna numerik; `^[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

Postingan pengguna

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`user_id`	Ya	`string`; ID pengguna numerik; `^[0-9]+$`
`end_cursor`	Tidak	`string`; Dicadangkan; tanpa paginasi

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

Postingan ulang pengguna

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`user_id`	Ya	`string`; ID pengguna numerik; `^[0-9]+$`
`end_cursor`	Tidak	`string`; Dicadangkan; tanpa paginasi

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

Balasan pengguna

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`user_id`	Ya	`string`; ID pengguna numerik; `^[0-9]+$`
`end_cursor`	Tidak	`string`; Dicadangkan; tanpa paginasi

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

Postingan berdasarkan ID numerik

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`post_id`	Ya	`string`; ID postingan numerik; `^[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

Postingan berdasarkan shortcode atau URL

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Setidaknya satu: post_id, url.

Kolom	Wajib	Kontrak
`post_id`	Tidak	`string`; Shortcode postingan
`url`	Tidak	`string`; URL postingan lengkap

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

Komentar postingan

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`post_id`	Ya	`string`; ID postingan numerik; `^[0-9]+$`
`end_cursor`	Tidak	`string`; Dicadangkan; tanpa paginasi

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

Pencarian terpopuler

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`query`	Ya	`string`; Istilah pencarian
`end_cursor`	Tidak	`string`; Dicadangkan; tanpa paginasi

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

Pencarian terbaru

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`query`	Ya	`string`; Istilah pencarian
`end_cursor`	Tidak	`string`; Dicadangkan; tanpa paginasi

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

Pencarian postingan

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`query`	Ya	`string`; Istilah pencarian

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

Pencarian profil

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

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Kolom	Wajib	Kontrak
`query`	Ya	`string`; Istilah pencarian

bash

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

Respons

Pembungkus JSON code/data asli dan presisi angka dipertahankan. Keberhasilan memerlukan code=200 dan data yang tidak null. Kesalahan bisnis dengan HTTP 200 merupakan kegagalan. Struktur respons berbeda menurut endpoint; contoh ini bersifat ilustratif, bukan respons langsung.

json

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

Kesalahan

HTTP 400: parameter tidak valid; 401: kegagalan autentikasi; 402: kredit tidak cukup; 403: akses ditolak; 405: metode tidak didukung; 408: pembatalan; 429: batas laju; 5xx: kegagalan layanan atau hulu, termasuk batas waktu 504. Simpan X-Request-Id untuk diagnosis.

Sumber

Diperiksa terhadap OpenAPI V5.3.2 resmi dan harga endpoint pada 2026-10-31. Operasi fetch_post_id_from_url yang hanya tercantum dalam daftar harga tidak disertakan karena tidak ada dalam OpenAPI.

TikHub · OpenAPI · Harga