# Throk API で Threads の人気投稿を見つける

`GET /post/hot` はキーワードなしで、一定期間内で最も人気のある投稿を返します。ネタ探しや、市場でいま何が話題になっているかの把握に向いています。

## 直近 24 時間でいいねが最も多い台湾の投稿

```bash
curl -G 'https://premium-api.throk.ai/post/hot' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'language=tw' \
  --data-urlencode 'sort=like:desc' \
  --data-urlencode 'size=30'
```

## パラメータ

| パラメータ | 説明 | デフォルト |
| --- | --- | --- |
| `sort` | `like:desc`（いいね数）、`replies:desc`（返信数）、`impression:desc`（閲覧数） | `like:desc` |
| `size` | 返す件数。30〜200 | 30 |
| `from_timestamp` | 開始時刻（UNIX 秒）。最大 30 日前まで遡れる | 24 時間前 |
| `to_timestamp` | 終了時刻（UNIX 秒）。こちらも 30 日以内である必要がある | 現在 |
| `language` | 市場。[地域と言語](/ja/api/guides/regions/)を参照 | `zh` |
| `exclude_hk` | 広東語と香港式中国語の投稿を除外。`language=zh` の場合のみ有効 | `false` |

返される各投稿には、投稿者の情報と、閲覧数 `impression_count` を含むすべての数値が付きます。結果には通常の投稿と返信の両方が含まれます。

## 課金

30 件で 70 クレジット、1 件増えるごとに 2 クレジット追加されます（例：`size=100` なら 210 クレジット）。`sort=impression:desc` の場合は基本料金が 100 クレジットです。リクエストの `size` に基づいて課金されます。

## 関連ツール

MCP では、AI アシスタントで使いやすい既成のランキングもいくつか提供しています。

- `get_cool_replies`：神返信ランキング
- `get_post_like_growth`：バズ投稿（いいね数の伸びが最も速い投稿）
- `get_follower_growth`：フォロワーの伸びが最も速いアカウント
- `get_power_hours`：プラットフォームのゴールデンタイム（投稿に最適な時間帯）

詳しくは[AI アシスタントで使う（MCP）](/ja/api/mcp/#利用できるツール)をご覧ください。