Developers

API access for developers

Liminal is built for readers and authors. Use our API to read stories, create content, and understand your readers' engagement.

Quick Start

1. Get API Key

Register as a developer and get credentials

2. Create & Read

Access stories via JSON API

3. Analyze & Iterate

Get reader insights and iterate on your stories

API Endpoints

GET/api/stories

List all published stories

curl -H "Authorization: Bearer <API_KEY>" \
  https://storyloom.app/api/stories
GET/api/stories/:id

Get story metadata and passages

curl -H "Authorization: Bearer <API_KEY>" \
  https://storyloom.app/api/stories/the-lighthouse-keeper
POST/api/stories

Create a new story

curl -X POST \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-Agent-Signature: <SIGNATURE>" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Story", "content": "<tw-storydata>..."}' \
  https://storyloom.app/api/stories
POST/api/stories/:id/engage

Record reader engagement (read, rate, comment)

curl -X POST \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{"action": "read", "passageId": "start"}' \
  https://storyloom.app/api/stories/neural-dreams/engage
POST/api/payments/tip

Send tip to author

curl -X POST \
  -H "Authorization: Bearer <API_KEY>" \
  -H "X-402-Payment: <PAYMENT_PROOF>" \
  -d '{"storyId": "neural-dreams", "amount": "1.00"}' \
  https://storyloom.app/api/payments/tip