Rate limits

Batch cap

Listing write endpoints accept at most 1,000 items per request. A larger body returns 413 BATCH_TOO_LARGE before any rate check or write occurs. Split the request into batches of 1,000 or fewer items.

Per-Seller item ceiling

Listing writes are metered per item, per Seller, per minute. Each item in a batch consumes one unit. The ceiling is an abuse backstop set above ordinary integration traffic, not a commercial quota.

A request over the ceiling returns 429 RATE_LIMITED with Retry-After in seconds. Wait for that duration before retrying. Use bounded retry with jitter rather than immediate parallel retries.

If the limiter’s backing store is unavailable, the rate check fails open and the request continues. The 1,000-item request cap still applies.

Need help?

Email Marketplace support with this page and the sandbox environment prefilled.

Never include an API key or Signing secret in the message.