NOSIBLE World exposes a set of read-only HTTP endpoints that return event data as JSON, structured Markdown, and ZIP bundles. The API is designed for programmatic consumption: feed events into LLM pipelines, build dashboards, or archive daily intelligence to your own storage. Anonymous access is free with a modest rate limit — authenticated tiers unlock deeper history and higher throughput.
/api/events/[date]Event list for a date as JSON — paginated and sortable (limit, offset, sort_by, desc). Each event carries geo, coverage counts, signals, and ontology classification.
Response shape
{ "events": [ { "event_id", "title", "country", "coverage", "signals", … } ], "total", "count" }Sample request
curl "https://nosible.world/api/events/2026-06-15?limit=50"/api/events/[date]/[event_id]A single event as JSON — full structured record with classifications, signals, coverage metadata, and ontology.
Response shape
{ "event_id", "title", "date", "country", "coverage", "signals", "ontology", … }Sample request
curl https://nosible.world/api/events/2026-06-15/abc123/api/events/[date]/[event_id]/aggregatesPer-event aggregates — coverage over time, top netlocs, and language / country breakdowns for a single event.
Response shape
{ "per_hour": [ … ], "top_netlocs": [ … ], "languages": [ … ], "countries": [ … ] }Sample request
curl https://nosible.world/api/events/2026-06-15/abc123/aggregates/api/snapshots/[date]Full-day snapshot — every event for the date in one compact, columnar JSON payload (a shared field list plus rows), sorted by coverage. The bulk feed the map renders from.
Response shape
{ "schema": "nosible_world_snapshot_v1", "date", "total", "count", "fields": [ … ], "rows": [ [ … ] ] }Sample request
curl https://nosible.world/api/snapshots/2026-06-15/api/searchGlobal cross-date search — metadata, lexical, semantic, or hybrid, over a date range with filters, sort, and facets. An enterprise key searches the full archive; every other caller must set an explicit date.from within the past 30 days. A missing or older date.from is treated as a full-archive search and rejected with 403.
Response shape
{ "results": [ { "event_id", "score", … } ], "facets": { … }, "took_ms" }Sample request
curl -X POST https://nosible.world/api/search -H 'Content-Type: application/json' -d '{"q":"earnings","date":{"from":"2026-06-15"},"limit":20}'/api/events/[date]/searchStructured single-day search — filter (sentiment, materiality, IAB, geo, coverage, tickers, …), sort, and facet the events for one date.
Response shape
{ "events": [ … ], "total", "count", "facets": { … } }Sample request
curl -X POST https://nosible.world/api/events/2026-06-15/search -H 'Content-Type: application/json' -d '{"filters":{"countries":["US"]}}'/api/search/[date]Lightweight keyword search for one date — matches titles, IAB, country, and continent (q, limit). Useful for autocomplete.
Response shape
[ { "event_id", "title", "country", … } ]Sample request
curl "https://nosible.world/api/search/2026-06-15?q=tariffs&limit=5"/api/search/schemaFilter schema for global search — the field names, types, operators, and geo shapes accepted by POST /api/search.
Response shape
{ "schema": "nosible_world_search_schema_v1", "search_types": [ … ], "fields": [ … ] }Sample request
curl https://nosible.world/api/search/schema/api/markdown/index/[date]Flat daily event index in Markdown — all events for the date sorted by total_coverage descending. Each event block includes ID, geo, coverage counts, signals, and full ontology classification (IPTC, IAB, GICS, and optional ontologies).
Response shape
# NOSIBLE World — 2026-06-15
Daily index — 1,234 events. Sorted by coverage descending.
---
## Event Title
- **ID:** `event_id`
- **Date:** 2026-06-15
- **Country:** US · **Region:** Northern America · **Language:** en
- **Coverage:** 12,450 articles · 387 unique netlocs
- **Signals:** positive · high · weeks
- **IPTC Topic:** …
- **IAB:** …
Description prose…
[Full markdown →](/api/markdown/event/event_id)
---
…Sample request
curl https://nosible.world/api/markdown/index/2026-06-15/api/markdown/event/[event_id]Single event in Markdown — full structured write-up with classifications, entities, coverage URLs, and deep-dive analysis.
Response shape
# Event Title
**Date:** 2026-06-15 · **Country:** US
## Summary
…
## Classifications
…Sample request
curl https://nosible.world/api/markdown/event/abc123/api/markdown/bulk/[date]Full-day ZIP bundle — all events for the date in individual Markdown files, plus an index.md, packed into a single ZIP archive.
Response shape
Binary ZIP archive. Contains: index.md + events/{event_id}.md …Sample request
curl -O -J https://nosible.world/api/markdown/bulk/2026-06-15/api/ogDynamic OpenGraph image for an event or date. Used by social crawlers. Returns a 1200×630 PNG branded share card.
Response shape
1200×630 PNG — dark branded card with event title and metadata overlay.Sample request
curl -o card.png "https://nosible.world/api/og?event=abc123&date=2026-06-15"Public endpoints (past 30 days) accept unauthenticated requests — no API key required. Use them directly from curl, Python, or any HTTP client.
Enterprise API access — enterprise customers receive API keys, webhook endpoints, and rate-limit increases via their account manager. Authenticated requests pass the key in the Authorization header using the Bearer scheme:
Authorization: Bearer nos_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxSee /pricing for a full breakdown of what each tier unlocks, or book a demo to get started with Enterprise access.
Limits apply on a rolling 60-second window per API key (or per source IP for anonymous access). Exceeding the limit returns 429 Too Many Requests with a Retry-After header.
| Tier | Limit | Notes |
|---|---|---|
| Public | 60 req / min | No API key required. 30-day lookback window on bulk and index endpoints. |
| Enterprise | Custom (negotiated) | API key in Authorization header. Full 30-year archive access. Rate limits per contract. |
Limits are indicative and may be adjusted as capacity scales. Contact enterprise@nosible.com for higher limits on custom plans.
Fetching the daily Markdown index — the most common starting point for building on the NOSIBLE World API.
curl https://nosible.world/api/markdown/index/2026-06-15import httpx
resp = httpx.get(
"https://nosible.world/api/markdown/index/2026-06-15",
headers={"Authorization": "Bearer YOUR_API_KEY"}, # omit for anonymous
)
resp.raise_for_status()
print(resp.text)const res = await fetch(
"https://nosible.world/api/markdown/index/2026-06-15",
{
headers: { Authorization: "Bearer YOUR_API_KEY" }, // omit for anonymous
},
);
if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
const markdown = await res.text();
console.log(markdown);Enterprise customers receive API keys, webhook endpoints, and rate-limit increases via their account manager. Book a demo to get started.