Get a game's feeds

​

Returns download links and metadata for all three of a game's feeds: the products catalog, the expansions list, and current prices.

Each feed is a gzip-compressed, newline-delimited JSON file (one record per line). A feed is null until it has been generated for the first time.

Each url is a time-limited download link. Request this endpoint again to get fresh links once they expire.

The feed file formats and record shapes are documented at https://docs.cardnexus.com/feeds.

Authentication is required (any valid API key); no scope.

Path Parameters
  • gameId
    Type: string
    min length:  
    1
    required

    The game's identifier (e.g. mtg, pokemon). Returned by GET /v1/games.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/feeds/{gameId}
curl 'https://public-api.cardnexus.com/v1/feeds/{gameId}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "catalog": {
    "feedType": "catalog",
    "url": "https://cardnexus-feeds.s3.eu-west-1.amazonaws.com/feeds/mtg/catalog.ndjson.gz?X-Amz-Expires=3600&X-Amz-Signature=8a1f...",
    "urlExpiresAt": "2026-06-08T15:04:11.000Z",
    "checksum": "9f2c4e1b7d3a6f508c2e9b1d4a7f0c3e6b9d2f5a8c1e4b7d0a3f6c9e2b5d8f1a",
    "sizeBytes": 5242880,
    "recordCount": 18432,
    "format": "ndjson",
    "encoding": "gzip",
    "lastRefreshedAt": "2026-06-08T14:04:11.000Z",
    "generatedAt": "2026-06-05T02:11:47.000Z"
  },
  "expansions": {
    "feedType": "expansions",
    "url": "https://cardnexus-feeds.s3.eu-west-1.amazonaws.com/feeds/mtg/expansions.ndjson.gz?X-Amz-Expires=3600&X-Amz-Signature=2b7d...",
    "urlExpiresAt": "2026-06-08T15:04:11.000Z",
    "checksum": "4a7f0c3e6b9d2f5a8c1e4b7d0a3f6c9e2b5d8f1a9f2c4e1b7d3a6f508c2e9b1d",
    "sizeBytes": 81920,
    "recordCount": 642,
    "format": "ndjson",
    "encoding": "gzip",
    "lastRefreshedAt": "2026-06-08T14:04:11.000Z",
    "generatedAt": "2026-06-05T02:11:47.000Z"
  },
  "prices": {
    "feedType": "prices",
    "url": "https://cardnexus-feeds.s3.eu-west-1.amazonaws.com/feeds/mtg/prices.ndjson.gz?X-Amz-Expires=3600&X-Amz-Signature=c3e6...",
    "urlExpiresAt": "2026-06-08T15:04:11.000Z",
    "checksum": "1e4b7d0a3f6c9e2b5d8f1a9f2c4e1b7d3a6f508c2e9b1d4a7f0c3e6b9d2f5a8c",
    "sizeBytes": 3145728,
    "recordCount": 17004,
    "format": "ndjson",
    "encoding": "gzip",
    "lastRefreshedAt": "2026-06-08T03:22:09.000Z",
    "generatedAt": "2026-06-08T03:22:09.000Z"
  }
}

Feed metadata returned.