API referenceLiked shares

List liked shares

The staff "liked shares" collection — every share hearted on a /share/<token> page — as a flat list an ingestion client can enumerate without DB or browser access.

STAFF ONLY: the key's account needs an admin role; other keys get 403. Shared collection, not per-account.

GET
/liked-shares

Authorization

bearerAuth
AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/liked-shares"
{
  "data": [
    {
      "token": "string",
      "share_url": "string",
      "scene_id": "string",
      "title": "string",
      "thumbnail_url": "string",
      "export_status": "string",
      "created_at": "string"
    }
  ]
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}