Developer Hub · v0

Build on the
signal layer.

The same live discourse engine behind AIDRAN — exposed as a structured API across records, stories, signals, entities, beats, and streams. Query the corpus. Trace story shifts. Build from the system watching how the world talks about AI.

$ curl https://app.aidran.ai/v1/records?source=reddit&limit=10 \
  -H 'Authorization: Bearer YOUR_KEY'
 
{
  "items": [
    {
      "id": "r_2611_0c41",
      "source": "reddit",
      "title": "On post-deployment monitoring...",
      "sentimentScore": -0.34,
      "publishedAt": "2026-05-09T06:11:00Z"
    }
  ],
  "nextCursor": "eyJ0czoxNzM..."
}

Endpoint groups · 10

Full reference →
Records5

Discourse records ingested from public source kinds.

GET/v1/records
GET/v1/records/{id}
GET/v1/records/{id}/embedding
GET/v1/records/{id}/entities
+1 more
Stories9

AI-generated editorial stories with citations and provenance.

GET/v1/stories/lead
GET/v1/stories
GET/v1/stories/count
GET/v1/stories/by-slug/{slug}
+5 more
Signals4

σ-thresholded novelty, velocity, and divergence detections.

GET/v1/signals
GET/v1/signals/feed
GET/v1/signals/{id}
GET/v1/signals/{id}/evidence
Topics2

Algorithmically-clustered discourse themes mapped to editorial beats.

GET/v1/topics
GET/v1/topics/{id}
Entities5

Named people, organisations, products, and concepts with mention analytics.

GET/v1/entities
GET/v1/entities/{id}
GET/v1/entities/by-slug/{entityKey}
GET/v1/entities/sitemap-pages
+1 more
Sources1

Per-source ingestion volumes and health for configured source kinds.

GET/v1/sources
Search4

Hybrid vector + keyword search across records, stories, entities, and topics.

POST/v1/search
GET/v1/search/quick
POST/v1/search/similar
POST/v1/search/embed
Stats6

Corpus-level timelines, sentiment distributions, and trending entities.

GET/v1/stats/global/timeline
GET/v1/stats/sources/{id}/timeline
GET/v1/stats/sentiment/timeline
GET/v1/stats/entities/trending
+2 more
Arcs2

Named temporal threads grouping related stories into editorial arcs.

GET/v1/arcs
GET/v1/arcs/{slug}
Stream2

Server-sent event streams for live signal updates.

GET/v1/stream/signals
GET/v1/stream/stories
Live · SSE

Signal stream via Server-Sent Events

Subscribe to /v1/stream/signals for real-time anomaly updates as the pipeline detects them. Heartbeats every 30 seconds.

text/event-stream

Other ways in

SDK · npmLive
npm i aidran

A typed TypeScript / JavaScript client. Auth, cursor pagination, and the live signal stream handled for you. Same Bearer key as the REST API.

SDK docs →
Docker · self-hostForthcoming
docker pull aidran/aidran

Container images for the AIDRAN client, plus reference compose charts for VPC and air-gapped deployments. Not yet shipped — we will tell you exactly where each piece stands.

Read the plan →
Full reference

The reference tab has full parameter docs, response shapes, and curl / TypeScript / Python examples for all 40 endpoints.

View reference →