REST API

Comments

Read the Inbox and draft replies.

List comments

GET/api/commentsscope: read
Query
viewneeds_reply | buying | complaints | questions | all
Default needs_reply.
limitinteger 1-50
Default 20.
curl https://www.zieads.com/api/comments?view=buying \
  -H "Authorization: Bearer zk_your_key"
Response 200
{
  "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: draft
Body
textstring, max 2200required
Reply 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."}'
Response 201
{
  "data": {
    "task_id": "7a10...",
    "status": "pending_approval",
    "message": "Waiting for approval in ZieAds (AI Analyst or the approvals list)."
  }
}