Skip to content

Building on the API

For a page with many listings, fetch GET /v1/items/{def}/{paint}/patterns once per item and look up each seed locally. Never make one /seeds/{seed} call per row. For a full local copy, fetch /v1/dump instead of crawling every item.

  • Send If-None-Match and handle 304. See Caching & conditional requests.
  • Responses are cached at the edge for 10 minutes. Polling faster re-reads the same response and spends your rate limit.
  • Check GET /v1/meta and re-fetch only when dataset_version changes.
you’re building… check cadence
a live overlay reacting to new guides GET /v1/meta, compare dataset_version every few minutes, not every second
a nightly mirror or search index GET /v1/dump with If-None-Match once a day
a single page load whatever endpoint fits the page once, on load

Spread requests out instead of firing them all at once. On a 429, wait Retry-After seconds. In a browser, the edge burst limit arrives as a network error: wait 10 seconds and retry. See Access & rate limits.