REST APIOverview

REST API

Base URL, authentication, response format and errors.


Base URL	`https://www.zieads.com/api`
Auth	Authorization: Bearer zk_your_key
Format	JSON in, JSON out. Dates are ISO 8601 in UTC.
Limit	Shared with MCP, per day

Responses

Success responses wrap the result in data. Creating something returns 201.

Response 200

{
  "data": {
    "accounts": [
      {
        "id": "6b1f0c2e-...",
        "platform": "instagram",
        "handle": "@kopikita",
        "connected_at": "2026-10-02T09:12:00Z"
      }
    ]
  }
}

Errors

Response 403

{
  "error": {
    "code": "insufficient_scope",
    "message": "This key does not have the \"draft\" scope"
  }
}

Status	code	Meaning
400	`invalid_request`	A parameter is missing or wrong. The message says which.
401	`unauthorized`	Missing, expired or revoked key.
403	`insufficient_scope`	The key cannot draft.
404	`not_found`	No such endpoint.
429	`rate_limited`	Daily limit reached.
500	`server_error`	Something broke on our side. Retry with backoff.

Endpoints

Method	Path	Scope
GET	/me	read
GET	/accounts	read
GET	/briefing	read
GET	/analytics	read
GET	/ads/summary	read
GET	/posts	read
POST	/posts	draft
GET	/comments	read
POST	/comments/:id/reply	draft
GET	/competitors	read
POST	/competitors	draft
GET	/guardian	read
GET	/actions	read