Feed Threads
Cari post publik di Threads dengan kata kunci atau topik, lihat percakapannya, dan balas.
Feed mencari post publik di Threads lewat salah satu akun Threads di 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
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 |
{
"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"
}
]
}limitadalah batas atas. Threads sering mengirim lebih sedikit, dan Tebar meneruskan semua yang dikirim. Pencarian tidak punya halaman berikutnya.media_urldanthumbnail_urladalah 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
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
Sebagian besar hasil pencarian adalah balasan (is_reply: true). Untuk membaca post yang dibalasnya:
GET /v1/accounts/{id}/threads/search/{postId}/threaddata 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
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.