Full dump

GET /api/v1/merchant/items/full-dump

Entire active catalogue in a single response. Regenerated every ~60 s, pre-gzipped in Redis. Use this for bulk sync instead of walking /items page by page.

Requires Authorization: Bearer mer_live_… (Authentication).

Headers

Header	Direction	Notes
`If-None-Match`	request	Send the previous `ETag` to receive `304 Not Modified`.
`Accept-Encoding`	request	Send `gzip` to get the compressed blob (much faster).
`ETag`	response	Strong ETag of the current dump.
`Last-Modified`	response	HTTP-date of the last regeneration.
`X-Items-Count`	response	Total items in the dump.
`Content-Encoding`	response	`gzip` when the client advertised it; otherwise omitted.

Example

curl --compressed "https://api.tradeon.market/api/v1/merchant/items/full-dump" \
  -H "Authorization: Bearer mer_live_…" \
  -H 'If-None-Match: "etag-from-previous-call"'

200 OK body:

{
  "generated_at": "2026-05-05T16:00:00.000Z",
  "items_count": 312487,
  "items": [ /* ... CatalogItem objects ... */ ]
}

Each entry follows the CatalogItem schema.

304 Not Modified — your ETag matches; no body.

Errors

HTTP	`code`	When
503	`FEED_NOT_READY`	Briefly after a deploy until the first dump is generated (≤60 s).

Catalog Buy