Empirica Research API

cURL

# List latest notes
curl https://empiricaai.org/api/v1/notes \
  -H "Authorization: Bearer emp_your_key_here"

# Fetch a specific note
curl https://empiricaai.org/api/v1/notes/levy-driven-stochastic-volatility \
  -H "Authorization: Bearer emp_your_key_here"

# Paginate
curl "https://empiricaai.org/api/v1/notes?limit=5&cursor=2026-05-18T10:00:00Z" \
  -H "Authorization: Bearer emp_your_key_here"

Python

import httpx

API_KEY = "emp_your_key_here"
BASE    = "https://empiricaai.org/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# Fetch all notes (paginated)
def get_all_notes():
    cursor, notes = None, []
    while True:
        params = {"limit": 100}
        if cursor:
            params["cursor"] = cursor
        r = httpx.get(f"{BASE}/notes", headers=HEADERS, params=params)
        r.raise_for_status()
        body   = r.json()
        notes += body["data"]
        cursor = body["meta"]["cursor"]
        if cursor is None:
            break
    return notes

# Get full content for a note
def get_note(slug: str) -> dict:
    r = httpx.get(f"{BASE}/notes/{slug}", headers=HEADERS)
    r.raise_for_status()
    return r.json()["data"]

notes = get_all_notes()
print(f"Found {len(notes)} notes")

first = get_note(notes[0]["slug"])
print(first["title"], "—", first["word_count"], "words")

JavaScript / TypeScript

const API_KEY = "emp_your_key_here";
const BASE    = "https://empiricaai.org/api/v1";
const headers = { "Authorization": `Bearer ${API_KEY}` };

// List notes
const res  = await fetch(`${BASE}/notes?limit=20`, { headers });
const body = await res.json();
console.log(`${body.meta.total} notes available`);

// Fetch full content
const slug    = body.data[0].slug;
const noteRes = await fetch(`${BASE}/notes/${slug}`, { headers });
const note    = (await noteRes.json()).data;
console.log(note.title, note.content_md.slice(0, 200));