REST API
Comments
Read the Inbox and draft replies.
List comments
GET
/api/commentsscope: readQuery
viewneeds_reply | buying | complaints | questions | allDefault needs_reply.
limitinteger 1-50Default 20.
curl https://www.zieads.com/api/comments?view=buying \
-H "Authorization: Bearer zk_your_key"{
"data": {
"comments": [
{
"id": "5d21...",
"platform": "instagram",
"author_username": "dinda.rahma",
"text": "Kak serumnya masih ready? Harga yang 30ml berapa ya?",
"intent": "buying_signal",
"sentiment": "neutral",
"status": "unread",
"posted_at": "2026-11-03T02:14:00Z"
}
]
}
}Draft a reply
POST
/api/comments/:id/replyscope: draftBody
textstring, max 2200requiredReply text.
curl -X POST https://www.zieads.com/api/comments/5d21.../reply \
-H "Authorization: Bearer zk_your_key" \
-H "Content-Type: application/json" \
-d '{"text":"Masih ready kak! Yang 30ml Rp149.000, cek link di bio ya."}'{
"data": {
"task_id": "7a10...",
"status": "pending_approval",
"message": "Waiting for approval in ZieAds (AI Analyst or the approvals list)."
}
}