v1 · Read-Only

Reacht API

A public read-only API for accessing Reacht communities, posts, and profiles. All endpoints require an API key. Rate limit: 100 requests per hour.

Authentication

Pass your API key in the X-Reacht-API-Key header with every request. API keys are generated in Settings → Developer.

curl https://reacht.app/api/v1/posts \
  -H "X-Reacht-API-Key: your_api_key_here"

Endpoints

GET/api/v1/posts?page=1&per_page=20

Paginated list of all public posts, sorted chronologically.

GET/api/v1/posts/:id

Single post with top-level comment thread.

GET/api/v1/communities

All public communities, sorted by member count.

GET/api/v1/communities/:slug/posts?page=1&per_page=20

Posts in a specific community.

GET/api/v1/profiles/:username

Public profile data for a member.

JavaScript / fetch example

const res = await fetch('https://reacht.app/api/v1/posts', {
  headers: { 'X-Reacht-API-Key': 'your_api_key_here' }
})
const { data, meta } = await res.json()
console.log(data) // array of posts

Response format

All responses follow the same envelope: { data, meta, error }. On success, error is null. On failure, data is null.

{
  "data": [
    {
      "id": 42,
      "title": "Hello Reacht",
      "body": "First post in the community...",
      "score": 14,
      "comment_count": 3,
      "created_at": "2026-06-01T12:00:00Z",
      "communities": { "slug": "general", "name": "General" },
      "profiles": { "username": "founder" }
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 84, "pages": 5 },
  "error": null
}

Rate limits

100

requests / hour / key

active keys / account

max per_page

Rate-limited responses return HTTP 429. Key usage stats are visible in Developer Settings.

Terms of use

The Reacht API is provided for personal, non-commercial, and open-source use. You may not use it to scrape or republish Reacht content in bulk, build competing products, or circumvent auth gates. Rate limits are enforced automatically. Abuse results in key revocation. By using the API you agree to Reacht's Terms of Service.