disease.sh

disease.sh COVID-19: NYT API

(COVID-19 data sourced from the New York Times, updated every 24 hours)

GitHub OpenAPI

Operations 5

GET /v3/covid-19/nyt/states Get COVID-19 time series data for all states, with an entry for each day since… #
GET /v3/covid-19/nyt/states/{state} Get COVID-19 time series data for a state or set of states, with an entry for… #
GET /v3/covid-19/nyt/counties Get COVID-19 time series data for all available US counties, with an entry for… #
GET /v3/covid-19/nyt/counties/{county} Get COVID-19 time series data for a county or set of counties, with an entry… #
GET /v3/covid-19/nyt/usa Get COVID-19 time series data for the entire USA, with an entry for each day… #

Documentation

📖
Documentation
https://disease.sh/docs/
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/disease-sh/refs/heads/main/rate-limits/rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/disease-sh/refs/heads/main/openapi/disease-sh-covid-19-nyt-api-openapi.yml

Other Resources

🔗
GitHub
https://github.com/disease-sh/API
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/disease-sh/refs/heads/main/plans/plans.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/disease-sh/refs/heads/main/finops/finops.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/disease-sh-covid-19-nyt-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

disease-sh-covid-19-nyt-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 3.0.0
  title: disease.sh Docs - An open API for disease-related…
  description: Third Party API for reliable global disease information
  license:
    name: GNU V3
    url: https://github.com/disease-sh/API/blob/master/LICENSE
host: disease.sh
basePath: /
schemes:
- https
- http
consumes:
- application/json
produces:
- application/json
tags:
- name: 'COVID-19: NYT'
  description: (COVID-19 data sourced from the New York Times, updated every 24 hours)
paths:
  /v3/covid-19/nyt/states:
    get:
      tags:
      - 'COVID-19: NYT'
      parameters:
      - name: lastdays
        in: query
        default: 30
        description: Number of days to return. Use 'all' for the full data set (e.g. 15, all, 24)
        type: string
      summary: Get COVID-19 time series data for all states, with an entry for each day since…
      responses:
        '200':
          description: Status Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/covidNYTState'
      operationId: getV3Covid19NytStates
      x-operation-id-source: derived
  /v3/covid-19/nyt/states/{state}:
    get:
      tags:
      - 'COVID-19: NYT'
      parameters:
      - name: state
        in: path
        required: true
        description: State name(s), separated by commas (e.g. 'Illinois, California')
        type: string
      - name: lastdays
        in: query
        default: 30
        description: Number of days to return. Use 'all' for the full data set (e.g. 15, all, 24)
        type: string
      summary: Get COVID-19 time series data for a state or set of states, with an entry for…
      responses:
        '200':
          description: Status Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/covidNYTState'
      operationId: getV3Covid19NytStatesByState
      x-operation-id-source: derived
  /v3/covid-19/nyt/counties:
    get:
      tags:
      - 'COVID-19: NYT'
      parameters:
      - name: lastdays
        in: query
        default: 30
        description: Number of days to return. Use 'all' for the full data set (e.g. 15, all, 24)
        type: string
      summary: Get COVID-19 time series data for all available US counties, with an entry for…
      responses:
        '200':
          description: Status Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/covidNYTCounty'
      operationId: getV3Covid19NytCounties
      x-operation-id-source: derived
  /v3/covid-19/nyt/counties/{county}:
    get:
      tags:
      - 'COVID-19: NYT'
      parameters:
      - name: county
        in: path
        required: true
        description: County name(s), separated by commas (e.g. 'Alameda, Humboldt')
        type: string
      - name: lastdays
        in: query
        default: 30
        description: Number of days to return. Use 'all' for the full data set (e.g. 15, all, 24)
        type: string
      summary: Get COVID-19 time series data for a county or set of counties, with an entry…
      responses:
        '200':
          description: Status Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/covidNYTCounty'
      operationId: getV3Covid19NytCountiesByCounty
      x-operation-id-source: derived
  /v3/covid-19/nyt/usa:
    get:
      tags:
      - 'COVID-19: NYT'
      summary: Get COVID-19 time series data for the entire USA, with an entry for each day…
      responses:
        '200':
          description: Status Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/covidNYTUSA'
      operationId: getV3Covid19NytUsa
      x-operation-id-source: derived
components:
  schemas:
    covidNYTCounty:
      type: array
      items:
        type: object
        properties:
          date:
            type: string
            format: date
          county:
            type: string
          state:
            type: string
          fips:
            type: string
          cases:
            type: number
          deaths:
            type: number
    covidNYTUSA:
      type: array
      items:
        properties:
          date:
            type: string
            format: date
          cases:
            type: number
          deaths:
            type: number
    covidNYTState:
      type: array
      items:
        type: object
        properties:
          date:
            type: string
            format: date
          state:
            type: string
          fips:
            type: string
          cases:
            type: number
          deaths:
            type: number
externalDocs:
  description: Find out more about this API
  url: https://github.com/disease-sh/API