Horbit Developers
Reactions & views

Toggles a reaction

POST
/v1/public/blog/posts/{post}/reactions

Adds the reaction, or removes it if this reader already left it. Returns the new counts. Only the types in GET /public/blog → reactions.types are accepted.

Authorization

x-api-key
headerx-api-key<token>

A tenant API key — secret (htk_…) or, where allowed, publishable (hpk_…).

Path Parameters

post*string

The post's slug (recommended) or id.

Request Body

application/json
  1. body
visitorId?string

Your own stable, anonymous id for the reader (e.g. a uuid kept in localStorage). Used to remember their reactions. Falls back to ip + user agent.

type*string
Value in"like""love""clap""insightful""celebrate""laugh"

Response Body

Counts per type, and the ones this reader left.

response?unknownapplication/json
curl -X POST 'https://api.horbit.ng/v1/public/blog/posts/five-lessons-open-data-hackathon/reactions' \  -H 'Content-Type: application/json' \  -d '{  "type": "like"}'
{  "status": true,  "message": "Reactions retrieved successfully",  "data": {    "enabled": true,    "total": 87,    "counts": {      "like": 51,      "love": 20,      "clap": 12,      "insightful": 4    },    "types": [      {        "type": "like",        "label": "Like",        "emoji": "👍"      }    ],    "mine": [      "like"    ]  }}