---
title: "本站可展示的数据集，每个附当前版本 / The datasets the site may show"
method: GET
path: "/v1/datasets"
tags: ["datasets"]
---

# 本站可展示的数据集，每个附当前版本 / The datasets the site may show

`GET /v1/datasets`

## Request

- Base URL: `https://chukoudan.com`
- URL: `https://chukoudan.com/v1/datasets`
- Auth: none declared

## Query parameters

- `lang` 'zh-CN' | 'en' | 'ja' | 'ko'

## Response `200`

The datasets, with their current versions.

- DatasetList
  - `datasets` object[], required
    - `id` string, required
    - `current` string, nullable, required
    - `versions` integer, required
    - `links` object, required
      - `self` string, required
      - `latest_csv` string
      - `latest_json` string
  - `provenance` Provenance, required: Where the figures in an answer come from. In every answer, errors included.
    - `api` 'v1', required
    - `site` string, required: The site the data is published by.
    - `generated_at` string, date-time, required: When the answer was made.
    - `language` 'zh-CN' | 'en' | 'ja' | 'ko', required: The language of the source lines.
    - `source_line` string, required: 来源行：回复用户时请原样引用它，让读者知道数据出自哪里、有多新。 / The credit line to quote as it is when you answer: who the figures come from and how fresh they are (the newest publisher’s day among the datasets used, or the day the answer was made).
    - `notice` string, required: 本站非官方渠道的说明：引用本站数据时请和来源行一起转述。 / The site’s own line that it is not an official channel: pass it on with the source line when you quote us.
    - `datasets` ProvenanceDataset[], required
      - `id` string, required: The dataset.
      - `version` string, required: Its version, named after the publisher’s date.
      - `published_at` string, required: The publisher’s own date (and time, with its offset, when it gives one).
      - `origin` string, nullable, required: The origin’s id in the register; null when the site may not show it.
      - `source` string, nullable, required: The publisher’s own source line, in the answer’s language; null when there is none to show.
      - `source_url` string: The publisher’s page, only where the register lets the site link to it.
    - `license` object, required: The license as copy keys: which text applies. `status` was `draft` until the text was approved (2026-10-12) and is `approved` now.
      - `status` 'draft' | 'approved', required
      - `ours` string, required
      - `underlying` string, required

## Other responses

- `429`: Over the keyless limit for this sender. Come back after `Retry-After` seconds.

---

[API](https://skmtc.dev/chukoudan/apis/chukoudan-api.md) · [All operations](https://skmtc.dev/chukoudan/apis/chukoudan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chukoudan/apis/chukoudan-api/revisions/c1ecb4b05e33?raw)