Rate Limiting

Rate Limiting

The ABOUT YOU Sellers Center API implements comprehensive rate limiting to ensure fair usage and optimal performance for all users. Rate limits are configured per endpoint and vary depending on the operation type and resource requirements.

How Rate Limiting Works

  • Authentication: Rate limits apply to authenticated API requests using your API key

  • Per-Endpoint Limits: Each endpoint has its own specific rate limit configuration

  • Headers: Current limit and remaining quota information is provided in response headers:

    • X-RateLimit-Limit: Total requests allowed in the time window

    • X-RateLimit-Remaining: Remaining requests in the current window

  • 429 Responses: When limits are exceeded, the API returns HTTP 429 (Too Many Requests)

Current Rate Limits by Endpoint

⚠️ Important: This table provides an overview of current rate limits, but you should always refer to the up-to-date API documentation for the most accurate and current rate limit information, as limits may be adjusted over time.

Resource Path
Method
Rate Limit
Description

Webhooks

/webhooks/types

GET

50/min

Get webhook event types

/webhooks/

GET

50/min

List webhook subscriptions

/webhooks/

POST

50/min

Create webhook subscription

/webhooks/{id}

GET

50/min

Get webhook subscription

/webhooks/{id}

PATCH

100/min

Update webhook subscription

/webhooks/{id}

DELETE

50/min

Delete webhook subscription

Products

/products/

GET

1000/min

List/search products

/products/rejected

GET

50/min

Get rejected products

/products/

POST

100/min

Create/update products

/products/status

PATCH

100/min

Update product status

/products/stock

PATCH

1000/min

Update product stock

/products/price

PATCH

200/min

Update product prices

Orders

/orders/

GET

100/min

List orders

/orders/{number}/delivery-document

GET

100/min

Get delivery document

/orders/cancel

POST

50/min

Cancel order items

/orders/ship

POST

50/min

Ship order items

/orders/return

POST

50/min

Return order items

Results

/results/products

GET

200/min

Get product batch results

/results/status

GET

200/min

Get status update results

/results/stock

GET

200/min

Get stock update results

/results/price

GET

200/min

Get price update results

/results/cancel

GET

200/min

Get cancellation results

/results/ship

GET

200/min

Get shipment results

/results/return

GET

200/min

Get return results

Reports

/reports/

GET

10/min

List available reports

/reports/{id}/download

GET

10/min

Download report file

Categories

/categories/

GET

100/min

List categories

/categories/{id}/attribute-groups

GET

300/min

Get category attribute groups

Countries

/countries/

GET

100/min

List countries and locales

Brands

/brands/

GET

50/min

List available brands

Best Practices

  1. Monitor Headers: Always check the rate limit headers in responses to track your usage

  2. Implement Retry Logic: Handle 429 responses gracefully with exponential backoff

  3. Batch Requests: Use batch endpoints when available rather than individual requests

  4. Cache Results: Cache API responses where appropriate to reduce request frequency

  5. Plan Operations: For bulk operations, plan your requests within the rate limits

Official Documentation

For the most current rate limit information, endpoint details, and any updates, always refer to the official API documentation:

https://partner.aboutyou.com/api/v1/docs

The documentation is automatically generated and always reflects the current API configuration, including any rate limit adjustments.

Last updated

Was this helpful?