{
 "name": "slashyear",
 "description": "Every recorded year, calendar day, decade, century and subject in history as static JSON. Each entry carries the English Wikipedia revision id its sentence was quoted from.",
 "documentation": "https://slashyear.com/api",
 "base": "https://slashyear.com",
 "auth": null,
 "cors": true,
 "rate_limit": null,
 "license": "CC BY-SA 4.0",
 "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
 "attribution": "Each record carries the English Wikipedia article title and revision id its sentence was quoted from; attribute those.",
 "bulk_download": "https://slashyear.com/dump/datapackage.json",
 "llms_txt": "https://slashyear.com/llms.txt",
 "mcp": {
  "url": "https://slashyear.com/mcp",
  "transport": "streamable-http",
  "auth": null
 },
 "endpoints": [
  {
   "path": "/api/years.json",
   "description": "index of every published year"
  },
  {
   "path": "/api/year/{year}.json",
   "description": "one year; astronomical numbering, so -43 is 44 BCE"
  },
  {
   "path": "/api/dates.json",
   "description": "index of all 366 calendar dates"
  },
  {
   "path": "/api/date/{month-day}.json",
   "description": "one calendar day across every year"
  },
  {
   "path": "/api/cross.json",
   "description": "index of every century, decade, subject and country"
  },
  {
   "path": "/api/place/{country}.json",
   "description": "one country's record, century by century"
  },
  {
   "path": "/api/century/{slug}.json",
   "description": "one century: its decades, subjects and highlights"
  },
  {
   "path": "/api/decade/{slug}.json",
   "description": "one decade: its years and their leading entries"
  },
  {
   "path": "/api/topic/{slug}.json",
   "description": "one subject across every century"
  },
  {
   "path": "/api/topic/{slug}/{century}.json",
   "description": "one subject inside one century"
  },
  {
   "path": "/api/entities.json",
   "description": "index of every subject that has a timeline"
  },
  {
   "path": "/api/entity/{slug}.json",
   "description": "one subject: every dated entry naming it, in order, with its Wikidata id"
  },
  {
   "path": "/api/search?q={query}",
   "description": "subjects matching a query and their dated entries; &from= &to= &limit="
  },
  {
   "path": "/api/facts/{year}.json",
   "description": "one year, 1800-2025, from outside series: world population, U.S. prices and CPI, who led every state, Billboard Hot 100 No. 1s; each figure with its source"
  },
  {
   "path": "/api/facts/index.json",
   "description": "which years have which facts"
  },
  {
   "path": "/api/prices.json",
   "description": "U.S. CPI and average prices by year (BLS, Census, DOL via FRED)"
  },
  {
   "path": "/api/hot100.json",
   "description": "every Billboard Hot 100 No. 1 by issue date, with its Wikipedia revision"
  },
  {
   "path": "/api/play/{month}.json",
   "description": "the guess-the-year puzzles for one month (YYYY-MM)"
  },
  {
   "path": "/api/asof/{date}",
   "description": "the world on one date (YYYY-MM-DD): that day's entries, office holders that year, the Hot 100 No. 1 in force, prices, population, official series, Fed exchange rates and Nobel Prizes, each with its source"
  },
  {
   "path": "/api/check?claim={claim}",
   "description": "check one dated sentence against the record: structured verdicts for leaders, No. 1 singles and Nobel Prizes, dated evidence for anything else"
  },
  {
   "path": "/api/nobel.json",
   "description": "every Nobel Prize by year, from the Nobel Prize API, kept where Wikidata agrees"
  },
  {
   "path": "/api/disagreements.json",
   "description": "where Wikipedia, Wikidata and the Nobel Prize record disagree, both sides quoted"
  },
  {
   "path": "/api/official/index.json",
   "description": "official data series (BLS, BEA, Treasury, Fed, NOAA...) and their cross-checks"
  },
  {
   "path": "/api/official/{series}.json",
   "description": "one official series with every native value (annual, monthly, daily)"
  },
  {
   "path": "/api/bench/summary.json",
   "description": "SlashYear-Bench: closed-book scores of language models on dated history"
  },
  {
   "path": "/dump/events.ndjson.gz",
   "description": "every dated entry on the site, gzipped newline-delimited JSON"
  },
  {
   "path": "/dump/years.ndjson.gz",
   "description": "one record per year"
  },
  {
   "path": "/dump/entities.ndjson.gz",
   "description": "one record per subject timeline"
  },
  {
   "path": "/dump/datapackage.json",
   "description": "Frictionless description of the three dumps"
  }
 ]
}