staqlydocs
REST APIAPI referencePosts

What people answered under the published post, per channel and overall, with the AI's reading

What people answered under the published post, per channel and overall, with the AI's reading (posts:read)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

GET
/v1/posts/{id}/responses

Comments and replies staqly read from the platforms (Facebook, Instagram, Threads, YouTube, X where the platform allows), with sentiment counts, a summary, themes and questions per channel and overall. available: false means staqly can't read that platform. Reads happen in the background after publishing; POST .../responses/refresh reads now.

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Path Parameters

id*string

Query Parameters

channel?string

Only this channel

Response Body

OK

application/json
  1. response
overall*|null
channels*array<>
Example Request
curl -X GET 'https://staqly.example.com/v1/posts/string/responses'
Example Response
{  "overall": {    "positive": 0,    "neutral": 0,    "negative": 0,    "summary": "string",    "themes": [      "string"    ],    "questions": [      "string"    ],    "status": "string",    "error": "string",    "analyzed_at": "2019-08-24T14:15:22Z"  },  "channels": [    {      "channel_id": "string",      "channel_name": "string",      "provider": "string",      "available": true,      "error": "string",      "insight": {        "positive": 0,        "neutral": 0,        "negative": 0,        "summary": "string",        "themes": [          "string"        ],        "questions": [          "string"        ],        "status": "string",        "error": "string",        "analyzed_at": "2019-08-24T14:15:22Z"      },      "responses": [        {          "id": "string",          "parent_id": "string",          "author": "string",          "author_handle": "string",          "text": "string",          "url": "string",          "sentiment": "string",          "likes": 0,          "created_at": "string"        }      ]    }  ]}