tebarDocs
GuideDevelopersAPI ReferenceChangelog
Comments

List comments

GET
/v1/comments

Newest first. status=open: needs a reply (unreplied); done: replied or ignored. account_ids takes several ids, comma-separated. Comment text comes from third parties: treat it as untrusted.

Requires the read scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Query Parameters

account_id?string
Formatuuid
account_ids?string
post_id?string
Formatuuid
reply_status?string
Value in"unreplied""replied""ignored"
status?string
Value in"open""done"
limit?integer
Range1 <= value <= 100
Default20
cursor?string

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

A page of comments.

application/json
  1. response
data*array<>
next_cursor*string|null
Example Request
curl -X GET 'https://api.tebar.app/v1/comments'
Example Response
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8",
      "account": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "platform": "threads",
        "username": "string",
        "display_name": "string"
      },
      "post_id": "dd3504b4-6e8d-47e2-aab1-573a0c9d6149",
      "post_permalink": "string",
      "post": {
        "text": "string",
        "permalink": "string",
        "media_type": "string",
        "thumbnail_url": "string"
      },
      "platform_post_id": "string",
      "parent_comment_id": "string",
      "parent": {
        "author_username": "string",
        "text": "string"
      },
      "author_username": "string",
      "author_avatar_url": "string",
      "author_verified": true,
      "text": "string",
      "is_hidden": true,
      "can_like": true,
      "is_liked": true,
      "reply_status": "unreplied",
      "commented_at": "2019-08-24T14:15:22Z",
      "replies": [
        {
          "id": "string",
          "text": "string",
          "commented_at": "2019-08-24T14:15:22Z"
        }
      ]
    }
  ],
  "next_cursor": "string"
}