Introduction

Get started with the RepriceMax API

RepriceMax is the retailer's operating system. We've set out to build the most powerful and extensible platform for resellers to manage their ecommerce businesses across Amazon and Walmart.

Start building #

Authentication

Learn how to authenticate your API requests.

Authentication

Secure your API requests with authentication

The RepriceMax API uses API keys to authenticate requests. You can view and manage your API keys in your account settings. Include your API key in the X-API-KEY header.

Base URL

https://api.repricemax.com

API Key Header

All API requests must include your API key in the X-API-KEY header:

Header

X-API-KEY: your_api_key

Managing API Keys

You can create and manage API keys from your account settings. Keep your API keys secure and never share them publicly.

Rate Limits

Understand API rate limiting and quotas

The API implements rate limiting to ensure fair usage. The global rate limit is 5 requests per second per API key.

Rate Limit Tiers

Requests/second	Requests/minute
5	300

Need higher limits? Contact our sales team to discuss enterprise rate limits for high-volume applications.

Listings

Manage products and eligibility across marketplaces

The Listings API allows you to retrieve, create, and update your product catalog. Manage inventory, pricing, and eligibility across Amazon and Walmart marketplaces.

Endpoints

GET /v1/listings List all listings

Example Request

curl https://api.repricemax.com/v1/listings \
  -H "X-API-KEY: your_api_key"

GET /v1/listings/{id} Get a listing

Example Request

curl https://api.repricemax.com/v1/listings/123e4567-e89b-12d3-a456-426614174000 \
  -H "X-API-KEY: your_api_key"

PATCH /v1/listings/{id}/price Update listing price

Example Request

curl -X PATCH https://api.repricemax.com/v1/listings/123e4567-e89b-12d3-a456-426614174000/price \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"minPrice": 10.99, "maxPrice": 25.99}'

PATCH /v1/listings/{id}/strategy Assign strategy

Example Request

curl -X PATCH https://api.repricemax.com/v1/listings/123e4567-e89b-12d3-a456-426614174000/strategy \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"strategyId": "987fcdeb-51a2-43c1-z567-987654321000"}'

Reports

Access your generated reports

Retrieve a list of your report runs, including status, download links (if applicable), and metadata.

Endpoints

GET /v1/reports List report runs

Example Request

curl https://api.repricemax.com/v1/reports \
  -H "X-API-KEY: your_api_key"

Strategies

Create, update, and test pricing strategies

Retrieve available pricing strategies that you have configured in the dashboard. Strategies control how your prices adjust to market conditions.

Endpoints

GET /v1/strategies List strategies

Example Request

curl https://api.repricemax.com/v1/strategies \
  -H "X-API-KEY: your_api_key"

Error Handling

Handle API errors gracefully

RepriceMax uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success, 4xx indicate client errors, and 5xx indicate server errors.

HTTP Status Codes

Code	Description
`200`	Success
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid API key
`404`	Not Found - Resource doesn't exist
`429`	Too Many Requests - Rate limited
`500`	Server Error

Error Response Format

Error Response Example

{
  "error": {
    "code": "invalid_request",
    "message": "The listing ID provided is invalid.",
    "param": "listing_id",
    "doc_url": "https://docs.repricemax.com/errors/invalid_request"
  }
}