AUSPEX API

Programmatic access to the AUSPEX incident corpus, documents, and analysis engine. Free tier: read-only incident data. Analyst tier: full analysis + AI endpoints.

AUTHENTICATION

Include your API key in the Authorization header:

Authorization: Bearer nx_your_api_key_here

Endpoints marked with require an Analyst or Enterprise plan.

GET/api/incidents

List all incidents with optional filtering

credibilitystring— Filter: CONFIRMED, HIGH, MEDIUM, LOW, UNVERIFIED

observablesstring— Comma-separated: ANTI_GRAVITY,TRANSMEDIUM

near_nuclearboolean— Only incidents near nuclear facilities

date_fromstring— ISO date lower bound

date_tostring— ISO date upper bound

regionstring— NA, EU, APAC, LATAM, MENA

limitnumber— Max results (default 50)

GET/api/incidents/:id

Get a single incident with full analysis (sky context, corroboration, similar incidents)

GET/api/documents

List all indexed documents with metadata

sourcestring— Filter by source: CIA, FBI, AARO, etc.

GET/api/analysis/clusters

DBSCAN spatial clusters with significance ratings

eps_kmnumber— DBSCAN epsilon in km (default 250)

min_ptsnumber— Minimum points per cluster (default 3)

GET/api/analysis/proximity

Nuclear proximity chi-squared analysis

radius_kmnumber— Proximity radius in km (default 100)

POST/api/ai/extract

AI entity extraction from text (Claude-powered)

textstring— Document text to analyze

POST/api/ai/search

Semantic vector search across all documents and incidents

querystring— Natural language search query

limitnumber— Max results (default 10)