# AI Analytics
> Cross-vertical public-data hub for AI agents and crawlers.

**Production host: `https://api.ai-analytics.org`** (all endpoint paths below resolve there). The marketing site is at `https://ai-analytics.org`.

**MCP server** at `https://api.ai-analytics.org/mcp` — connect Claude Desktop, Cursor, or any MCP-capable agent with:
```json
{ "mcpServers": { "ai-analytics": { "url": "https://api.ai-analytics.org/mcp" } } }
```
17 tools including the cross-vertical ones: search, dossier, company_profile, company_risk_flags, company_insider_pulse, cluster_buys, cluster_sells, upcoming_sales_pressure, news, upcoming_earnings, fund_holdings, fda_firm_dossier, drug_label, watchlist, **entity_timeline, entity_material_events, cross_vertical_active**.

A cross-vertical regulatory hub. Every paid competitor (Equilar, WhaleWisdom, Citeline) is built around one regulator's identifier system — they can only see SEC, or only FDA, or only federal contracts. We bridge them via an entity_master table that joins CIK (SEC), UEI (federal contracts), LEI (GLEIF global), DUNS (legacy), to one entity_id. A single call to `/api/v1/entity/{ticker}/timeline` returns SEC filings + insider trades + Form 144 + Schedule 13D + FDA recalls + drug labels + federal contracts in one merged feed.

## The killer endpoints (start here)

- `/entity/{ticker}` — HTML cross-vertical timeline (e.g. `/entity/BSX` for Boston Scientific)
- `/api/v1/entity/{ticker}/timeline?days=180` — same as JSON
- `/api/v1/entity/{ticker}/material-events?days=180` — filtered to importance ≥ 60 (Class I recalls, 13D filings, big insider sales)
- `/api/v1/cross-vertical/active?days=90` — discovery list of entities with activity in 2+ regulatory verticals

## Active topics — live data

| Topic | Coverage |
|---|---|
| `sec` | EDGAR filings (18k+), Form 4 insider txns, 13F holdings, XBRL financials, NPORT-P mutual funds, 8-K/10-K/10-Q section bodies |
| `fda` | Drug/device/food recalls, FAERS adverse events, 510(k) clearances |
| `register` | Federal Register rules, proposed rules, executive orders, presidential documents |
| `weather` | Active NOAA hazard alerts (Tornado/Flood/Fire warnings, etc.) |
| `climate` | USGS earthquake events worldwide (M4+) |
| `contracts` | USAspending federal contract awards (schema live; ingest pending Cloudflare↔origin SSL fix) |

## URL grammar
Every artifact section has one canonical URL of the form:
```
/{topic}/{entity}/{doc-type}/{period}/{section}
```
Examples:
- `/sec/useg/8-k/2026-05-08/item-5-02`  — Form 8-K Item 5.02 (director departure)
- `/sec/aapl/10-k/2024/risk-factors` — when 10-K parsed
- `/fda/drug/recalls/D-0500-2026` — recall summary
- `/register/2026-05-13/2026-09524` — Federal Register Proposed Rule
- `/weather/alerts/{nws-alert-id}` — active NOAA hazard

Append `.json` for structured response, `.md` for clean Markdown, `.html` for raw HTML (where stored).

## Discovery
- `/openapi.json` — machine-readable OpenAPI 3.1 (40+ endpoints across SEC, FDA, register, weather, climate)
- `/sitemap.xml` — paginated; every section URL listed
- `/feed.json?topic=sec&limit=50` — JSON Feed v1.1 of newest documents
- `/today.json` — daily cross-topic pulse (top insider sells, severe weather, presidential docs, etc.)
- `/api/v1/topics` — what's here per topic, with counts + example endpoints
- `/api/v1/stats` — comprehensive aggregate counts
- `/api/v1/search?q=...&topic=...` — BM25 full-text search across all section bodies
- `/api/v1/agencies?source=sec|fda|register` — entities by source

## Example SEC queries
- `/sec/AAPL/profile` — comprehensive dossier
- `/sec/AAPL/peers` — peer companies in the same SIC industry
- `/sec/AAPL/financial-facts?concept=NetIncomeLoss&period=FY` — annual XBRL fact history
- `/sec/AAPL/insider-summary` — 7/30/90/365d insider activity windows
- `/api/v1/sec/compare?tickers=AAPL,MSFT,GOOGL` — side-by-side financials
- `/api/v1/sec/insider-leaderboard?days=30` — top sellers across all companies (deduped, non-derivative)
- `/api/v1/sec/insider-transactions/recent?min_usd=1000000&code=S` — biggest insider sales
- `/sec/AAPL/insider-pulse?days=90` — unified Form 4 + Form 144 timeline for one company
- `/api/v1/sec/cluster-buys?days=90&min_insiders=3` — companies with multiple insiders buying (conviction signal)
- `/api/v1/sec/cluster-sells?days=30&min_insiders=4&min_usd=10000000` — mass insider exits
- `/api/v1/sec/insider-trends?days=90&bucket=week` — insider buy/sell time-series
- `/api/v1/sec/form144/recent?min_usd=1000000` — upcoming insider sales (Rule 144 notices, predictive)
- `/api/v1/sec/upcoming-sales-pressure?days=30` — companies with most pending insider sales
- `/api/v1/sec/most-active?days=30` — companies with highest recent filing volume
- `/api/v1/sec/8k/by-item?item=5.02` — 8-K filings by item code (1.01 M&A, 4.02 restatements, 5.02 director changes, etc.)
- `/api/v1/sec/13dg/recent?type=13D` — Schedule 13D/G activist + passive position filings
- `/api/v1/sec/13f/recent?min_aum=1000000000` — top institutional filers by AUM
- `/api/v1/sec/securities/{CUSIP}/top-holders` — top 13F holders of a security
- `/api/v1/sec/filings/recent?form_type=8-K&days=7` — generic filing search
- `/api/v1/sec/funds/recent` — NPORT-P mutual fund metadata
- `/api/v1/sec/funds/{cik}/holdings` — what one mutual fund holds (per NPORT-P)
- `/api/v1/sec/funds/largest-positions?min_pct=10` — concentrated fund positions
- `/api/v1/sec/securities/{CUSIP}/fund-holders` — mutual funds holding a security
- `/api/v1/coverage` — operational snapshot with dataset sizes + queue depth

## Example FDA queries
- `/api/v1/fda/recalls/recent?product=drug&class=Class+I`
- `/api/v1/fda/adverse-events/recent?drug=COSENTYX&serious=1`
- `/api/v1/fda/510k/recent?applicant=Medtronic`

## Example Federal Register / Weather / Earthquake queries
- `/api/v1/register/recent?type=Proposed+Rule`
- `/api/v1/register/executive-orders`
- `/api/v1/weather/alerts/active?severity=Severe`
- `/api/v1/climate/earthquakes/recent?min_mag=5.0&days=14`
- `/api/v1/dossier?name=Pfizer` — cross-topic entity lookup
- `/today.json` — daily cross-topic pulse

## Access
- All endpoints currently free for everyone.
- AI-crawler section-body fetches are **logged** with a shadow price ($0.001/section) in preparation for [Cloudflare Pay Per Crawl](https://blog.cloudflare.com/pay-per-crawl/) once DNS moves to a Cloudflare zone — no payment is being collected today.
- Bulk-data tiers for enterprise: contact info@ai-analytics.org

## Identification
Recognized crawler identities (matched in `User-Agent`): GPTBot, ChatGPT-User, claude-web, anthropic-ai, Claude-User, PerplexityBot, Google-Extended, CCBot, bingbot, Applebot-Extended, Amazonbot, meta-externalagent, plus a generic-LLM bucket.

## Operated by
Nexcom Media — https://nexcom.media

## Related properties
- https://nexcom.media — publisher network
- https://voidly.ai — censorship measurement infrastructure