API Reference

Base URL: https://api.threadline.io/v1

Authentication

Sessions, API keys, and SSO tokens.

Comments API

Create, read, vote, and moderate comments.

Sites API

Manage sites, themes, and embed configuration.

Webhooks

Real-time event delivery to your backend.

API Explorer

api.threadline.io

List comments for a thread. Returns nested replies.

GET/v1/comments?thread_url=&site_id=

Example request

curl -X GET "https://api.threadline.io/v1/comments?thread_url=https%3A%2F%2Fexample.com%2Fpost&site_id=site_abc123" \
  -H "X-API-Key: tlk_live_abc123def456"

Example response

{
  "comments": [
    {
      "id": "cmt_abc123",
      "content": "Great article!",
      "author_name": "Jane",
      "upvotes": 12,
      "reaction_counts": {
        "funny": 1,
        "interesting": 3,
        "insightful": 2
      },
      "replies": [
        {
          "id": "cmt_reply1",
          "content": "Agreed.",
          "author_name": "Sam",
          "upvotes": 2,
          "reaction_counts": {},
          "replies": []
        }
      ]
    }
  ],
  "total": 47,
  "page": 1
}