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 クエリパラメーターを使用します。不明、重複、不正なフィールドは拒否されます。JavaScript の安全な整数範囲を超える値も、ID は文字列で保持してください。タイムアウトは 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).

少なくとも 1 つ: 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 と null 以外の data が必要です。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