FullDatasets
Datasets
Pricing Docs
Get a key
Docs

API reference

Bulk download

GET /v1/datasets

Dataset catalog, release manifest, and parquet URLs.

Markdown Full spec OpenAPI

Catalog: GET /v1/datasets lists books, food, and movies_tv with latest_release, source cadence, and last successful feed time.

curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
  https://api.fulldatasets.com/v1/datasets

{
  "datasets": [
    {
      "id": "movies_tv",
      "name": "Movies & TV",
      "schema_version": "movies_tv.v1",
      "latest_release": "2026-10.1",
      "sources": [
        { "id": "wikidata", "license": "CC0", "cadence": "daily", "last_succeeded_at": "…", "last_status": "succeeded" }
      ],
      "freshness": { "last_feed_at": "…", "expected_cadence": "daily" }
    }
  ]
}

Food releases: GET /v1/datasets/food/releases/latest (foods.parquet, brands.parquet, changes.parquet). Movies & TV: GET /v1/datasets/movies_tv/releases/latest (titles.parquet, people.parquet, credits.parquet, identifiers.parquet, changes.parquet). Same Bearer key.

Manifest plus time-limited download URLs for parquet files. Same Bearer key as the rest of the API. No MCP tool.

Resale of the dataset is prohibited. Dumps are for your own systems.

Request

curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
  https://api.fulldatasets.com/v1/datasets/books/releases/latest

Response `200`

{
  "release": "2026-09.2",
  "schema_version": "books.v1",
  "created_at": "…",
  "manifest": {},
  "downloads": {
    "manifest.json": { "url": "https://api.fulldatasets.com/v1/datasets/books/releases/2026-09.2/files/manifest.json", "expires_in": 3600 },
    "books.parquet": { "url": "…", "expires_in": 3600 },
    "changes.parquet": { "url": "…", "expires_in": 3600 },
    "redirects.parquet": { "url": "…", "expires_in": 3600 }
  }
}

Fetch each downloads.*.url with the same Authorization header. URLs expire in 3600 seconds. File route:

GET /v1/datasets/books/releases/{release}/files/{file}

File Contents
manifest.json Release metadata
books.parquet Denormalized bulk table
changes.parquet Changelog snapshot
redirects.parquet Retired id → surviving id

404 if no release is loaded or the file name is unknown.

See also