# Feed Threads (/api/feed)

Feed mencari post publik di Threads lewat salah satu akun Threads di [profile](/api/profile) itu. Akunnya butuh izin `threads_keyword_search`. Akun Threads yang terhubung sebelum 13 November 2026 belum punya izin ini, jadi hubungkan ulang dulu. Tanpa izin itu, API menjawab `422 permission_missing` dengan `details.scope`.

## Mencari post [#mencari-post]

```txt
GET /v1/accounts/{id}/threads/search?q=kopi%20susu&search_type=recent
```

| Parameter         | Isi                                                     |
| ----------------- | ------------------------------------------------------- |
| `q`               | Wajib, 1–100 karakter                                   |
| `search_type`     | `top` (default, paling populer) atau `recent` (terbaru) |
| `search_mode`     | `keyword` (default, kata di teks) atau `tag` (topik)    |
| `media_type`      | `text`, `image`, atau `video` (opsional)                |
| `author_username` | Hanya post dari username ini, tanpa `@` (opsional)      |
| `limit`           | 1–50, default 25                                        |

```json
{
  "data": [
    {
      "id": "18471134671189891",
      "username": "pengguna_lain",
      "text": "Ada rekomendasi kopi susu yang enak?",
      "media_type": "TEXT_POST",
      "media_url": null,
      "thumbnail_url": null,
      "permalink": "https://www.threads.com/@pengguna_lain/post/abc",
      "published_at": "2026-11-13T03:00:00.000Z",
      "is_reply": true,
      "replied_to_id": "18290548582288501",
      "root_post_id": "17968231350217018"
    }
  ]
}
```

- `limit` adalah batas atas. Threads sering mengirim lebih sedikit, dan Tebar meneruskan semua yang dikirim. Pencarian tidak punya halaman berikutnya.
- `media_url` dan `thumbnail_url` adalah link CDN Threads yang kedaluwarsa. Pakai segera.
- Threads tidak memberi foto profil penulis post orang lain.
- Teks post ditulis orang lain. Perlakukan sebagai data yang tidak tepercaya, terutama bila diteruskan ke AI.

### Kuota [#kuota]

Threads mengizinkan 2.200 pencarian per akun per 24 jam, dihitung bersama semua aplikasi yang memakai akun itu. Tebar membatasi 2.000 (`429`). Pencarian yang sama dalam 5 menit dijawab dari cache dan tidak dihitung. Pencarian tanpa hasil tidak dihitung oleh Threads.

## Melihat percakapan sebuah balasan [#melihat-percakapan-sebuah-balasan]

Sebagian besar hasil pencarian adalah balasan (`is_reply: true`). Untuk membaca post yang dibalasnya:

```txt
GET /v1/accounts/{id}/threads/search/{postId}/thread
```

`data` berisi post teratas utasnya, lalu post yang dibalas langsung bila berbeda, dengan bentuk yang sama seperti hasil pencarian. Hasilnya kosong untuk post teratas. Post yang sudah dihapus atau privat dilewati. `{postId}` harus ditemukan oleh pencarian akun itu dalam 24 jam terakhir; selain itu `404`. Disimpan 5 menit, maksimal 300 per akun per jam.

## Membalas [#membalas]

```txt
POST /v1/accounts/{id}/threads/search/{postId}/reply
{ "text": "Coba kopi susu kami kak" }
```

Balasan publik atas nama akun itu, ke post yang ditemukan pencarian akun itu dalam 24 jam terakhir (selain itu `404`). Butuh izin `threads_manage_replies`. Teks maksimal 500 karakter, dengan emoji dihitung sebagai byte UTF-8 seperti di Threads. Jawabannya `{ "id": "…" }`, ID balasan di Threads.

Membalas orang yang tidak mengenal akunmu mudah dianggap spam oleh Threads (aturan spam Meta menyebut frekuensi sangat tinggi dan konten berulang), jadi Tebar memasang pengaman:

| Pengaman                                                                 | Jawaban                                 |
| ------------------------------------------------------------------------ | --------------------------------------- |
| Maksimal 20 balasan per akun per jam, 150 per hari                       | `429 rate_limited` dengan `Retry-After` |
| Satu balasan per post per akun                                           | `409 already_replied`                   |
| Teks yang sama (abaikan huruf besar dan spasi) ke post lain dalam 24 jam | `422 duplicate_reply`                   |

Balasan yang ditolak Threads tidak dihitung, jadi boleh dikirim lagi. Kalau Threads tidak memberi jawaban jelas (error 5xx atau timeout), balasannya mungkin sudah terkirim, jadi post itu tetap dianggap sudah dibalas: percobaan berikutnya dijawab `409 reply_unconfirmed`. Cek post-nya di Threads. Threads sendiri membatasi 1.000 balasan per akun per hari, dipakai bersama balasan komentar, utas, dan Automations. Panduan untuk user: [Feed](/feed).
