{
 "openapi": "3.1.0",
 "info": {
  "title": "ChronoDrawer API",
  "version": "1.0.0",
  "description": "Month-by-month, cross-country database (1970-2025) of events, Japanese laws, openings, sports, music, films, TV, anime, games, manga, books, magazines, prizes, cars and phones, plus Tokyo weather and prices. Free, 60 requests/min. Please cite ChronoDrawer (https://chronodrawer.org) and each item's source."
 },
 "servers": [
  {
   "url": "https://chronodrawer.org"
  }
 ],
 "paths": {
  "/api/v1/search": {
   "get": {
    "operationId": "search",
    "summary": "Search titles, people and events",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "description": "Title, person or keyword (Japanese or English)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "genre",
      "in": "query",
      "required": false,
      "description": "Genre key",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "year_from",
      "in": "query",
      "required": false,
      "description": "From year",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "year_to",
      "in": "query",
      "required": false,
      "description": "To year",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Max 100",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Matching items"
     }
    }
   }
  },
  "/api/v1/month": {
   "get": {
    "operationId": "getMonth",
    "summary": "What happened / was released in a month (with Tokyo weather and prices)",
    "parameters": [
     {
      "name": "year",
      "in": "query",
      "required": true,
      "description": "Year",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "month",
      "in": "query",
      "required": true,
      "description": "Month 1-12",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "genre",
      "in": "query",
      "required": false,
      "description": "Genre key",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Max 200",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "offset",
      "in": "query",
      "required": false,
      "description": "Offset",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Items and context"
     }
    }
   }
  },
  "/api/v1/day": {
   "get": {
    "operationId": "onThisDay",
    "summary": "On this day in different years",
    "parameters": [
     {
      "name": "month",
      "in": "query",
      "required": true,
      "description": "Month",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "day",
      "in": "query",
      "required": true,
      "description": "Day",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "genre",
      "in": "query",
      "required": false,
      "description": "Genre key",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Max 200",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Items"
     }
    }
   }
  },
  "/api/v1/person": {
   "get": {
    "operationId": "personTimeline",
    "summary": "Timeline of a person's works and events (artist, director, author, etc.)",
    "parameters": [
     {
      "name": "name",
      "in": "query",
      "required": true,
      "description": "Person name (Japanese or English)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Max 200",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Items sorted by date"
     }
    }
   }
  },
  "/api/v1/entity": {
   "get": {
    "operationId": "getEntity",
    "summary": "Release/occurrence dates by country for a Wikidata item",
    "parameters": [
     {
      "name": "id",
      "in": "query",
      "required": true,
      "description": "Wikidata ID, e.g. Q332368",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Entity"
     }
    }
   }
  }
 }
}