Scopes
profile.read — Read your seller identity
listings.read — Read and export your own listings, including drafts
listings.write — Create drafts and update your own listings
listings.publish — Publish your listings under your existing plan and listing fee rules
listings.end — End your listings subject to existing bid and order protections
offline_access — Maintain access while you are away, for up to 30 days
Limits and failures
Access tokens last up to 10 minutes. Offline grants last up to 30 days. Refresh tokens rotate; replace the old token immediately and never reuse it.
Resource limits are shown in the API plan table and in each application's settings. New Starter apps have 30 requests per minute and 1,000 per UTC day shared across seller connections. Premium and Commercial require approval. On 429, honor Retry-After. On 401, refresh once if possible or reconnect. On 403, check scopes and permissions. On 404, verify ownership and the listing ID.
Publishing may debit the seller wallet under existing fee rules. Use drafts during development. This portal does not provide a public sandbox or waive fees.
System status