← Back

Lurkr REST API v1

Programmatic access to your saved intelligence.

Authentication

All endpoints require an API key in the Authorization header.

Authorization: Bearer lk_live_xxxxxxxx...

Create a key in Settings → API keys. The full key is shown only once.

Scopes

  • posts:read — list and read saved posts + AI summaries
  • opportunities:read — read business opportunities
  • reports:read — read weekly intelligence reports
  • imports:write — queue a Reddit URL for import

Rate limits

60 requests per minute per key. Exceeding returns 429.

Endpoints

GET/api/public/v1/postsposts:read

Paginated list. Query: limit (max 100), offset.

GET/api/public/v1/posts/{id}posts:read

Single post with AI summary.

GET/api/public/v1/opportunitiesopportunities:read

Business opportunities. Query: limit, offset.

GET/api/public/v1/reportsreports:read

Weekly reports (latest first).

GET/api/public/v1/reports/{id}reports:read

Single report including body JSON.

POST/api/public/v1/importsimports:write

Body: { "url": "https://reddit.com/r/.../comments/..." }

Example

curl https://lurkr.dev/api/public/v1/posts?limit=10 \
  -H "Authorization: Bearer lk_live_xxxxxxxx..."