REST API
Post
Membuat, menjadwalkan, mengubah, dan membatalkan post.
Buat post
POST /v1/posts
Authorization: Bearer tb_live_xxx
Idempotency-Key: 6f1c2b7e-0d8a-4f7e-9a51-2c1f7b0e9d34
Content-Type: application/json
{
"content": "Promo akhir pekan 🎉",
"media_ids": ["0b9d..."],
"targets": [{ "account_id": "a1.." }, { "account_id": "b2.." }],
"scheduled_at": "2026-10-15T09:00:00+07:00"
}| Field | Keterangan |
|---|---|
content | Teks post |
media_ids | Id media dari upload, sesuai urutan tampil |
targets | Akun tujuan (account_id dari GET /v1/accounts) |
scheduled_at | Opsional. Tanpa field ini post langsung diterbitkan |
Respons 201:
{
"id": "p1..",
"status": "scheduled",
"scheduled_at": "2026-10-15T02:00:00Z",
"targets": [
{
"id": "t1..",
"account_id": "a1..",
"platform": "instagram",
"status": "pending",
"permalink": null
},
{
"id": "t2..",
"account_id": "b2..",
"platform": "threads",
"status": "pending",
"permalink": null
}
]
}Penerbitan berjalan di latar belakang. Cek GET /v1/posts/{id}: setiap target berubah menjadi published beserta permalink, atau failed beserta error_code.
Satu video di Instagram otomatis terbit sebagai Reels. Dua media atau lebih menjadi carousel (Instagram maks 10, Threads maks 20).
Versi per akun
Setiap target boleh punya teks dan/atau media sendiri. Field yang tidak dikirim mengikuti versi bersama. content: "" berarti sengaja tanpa teks.
{
"content": "Kopi apa favoritmu?",
"targets": [
{ "account_id": "th..", "options": { "poll": { "options": ["Tubruk", "Susu"] } } },
{ "account_id": "ig..", "content": "Menu baru minggu ini ☕", "media_ids": ["m1.."] }
]
}Opsi per platform
Dikirim di targets[].options. Kunci yang tidak dikenal ditolak (400 invalid_options).
| Platform | Opsi | Aturan |
|---|---|---|
| Threads | thread: string[] | Utas: 1–10 bagian lanjutan, masing-masing ≤ 500 karakter |
| Threads | poll: { options: string[] } | 2–4 pilihan, 1–25 karakter. Hanya post tanpa media |
| Threads | link_attachment: url | Kartu link. Hanya post tanpa media |
| Threads | text_attachment: { text, link_url? } | Teks panjang ≤ 10.000 karakter. Hanya post tanpa media |
| Threads | topic_tag: string | 1–50 karakter, tanpa . dan & |
| Threads | reply_control | everyone, accounts_you_follow, mentioned_only, followers_only, parent_post_author_only |
format: "feed" | "story" | Story: tepat 1 media, tanpa caption, video 3–60 detik dan ≤ 100 MB | |
share_to_feed: boolean | Reels saja (default true) | |
cover_media_id / thumb_offset_ms | Cover Reels: id gambar, atau frame video dalam milidetik |
Threads membatasi 5 link unik per post (400 too_many_links).
Mengelola post
| Request | Fungsi |
|---|---|
PATCH /v1/posts/{id} | Ubah content, media_ids, atau scheduled_at post yang belum terbit |
DELETE /v1/posts/{id} | Batalkan post terjadwal |
POST /v1/posts/{id}/publish | Terbitkan sekarang |
POST /v1/posts/{id}/retry | Ulangi akun yang failed. Tidak memposting ulang yang sudah terbit |
POST /v1/posts/{id}/remove | Hapus dari riwayat Tebar. Post di Instagram/Threads tidak ikut terhapus |
Post yang sudah mulai diterbitkan tidak bisa diubah (409 post_not_editable).