[DEV] Price Monitor - Competitive Price Intelligence

Introduction

Welcome to the Price Monitor API! Our RESTful API allows you to integrate your applications with our platform programmatically.

Base URL: https://dev.price-monitor.com/api/v1/

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

You can manage your API keys in your account settings.

API Endpoints

The complete, always up-to-date reference with every field, error code and example is generated from our OpenAPI specification:

Open the API reference Download openapi.yaml

Method	Path	Purpose
GET	`/api/v1/shops`	Your shops and their marketplaces
GET	`/api/v1/products`	List products (filters, pagination)
POST	`/api/v1/products`	Create a product
POST	`/api/v1/products/bulk`	Create or update up to 1000 products
GET / PATCH / DELETE	`/api/v1/products/{id}`	Read, update, delete a product
GET	`/api/v1/products/{id}/competitors`	Competitor offers from the last crawl
GET	`/api/v1/products/{id}/price-history`	Price history
POST	`/api/v1/products/{id}/reprice`	Recalculate the optimal price
POST	`/api/v1/products/{id}/apply-price`	Take over the optimal price as your own price
GET	`/api/v1/recommendations`	Products whose optimal price differs from yours
GET	`/api/v1/usage`	Plan limits and current usage

# List products with an unconfirmed or missing minimum price
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://dev.price-monitor.com/api/v1/products?limits=missing"

# Recalculate and take over the optimal price
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" https://dev.price-monitor.com/api/v1/products/42/reprice
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" https://dev.price-monitor.com/api/v1/products/42/apply-price

Error Handling

The API uses standard HTTP status codes (400, 401, 403, 404, 409, 429, 500). Every error has the same JSON shape with a stable machine-readable code:

{
  "error": {
    "code": "validation_error",
    "message": "The product is invalid.",
    "details": {"min_price": "must not be greater than max_price"}
  }
}

Rate Limits

API access and the daily request quota depend on your plan (see Pricing); the quota resets at 00:00 UTC. In addition, each account may send a limited number of requests per minute. Responses include X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. When a limit is reached the API returns 429 with a Retry-After header. GET /api/v1/usage shows your current limits and usage.

Webhooks

Webhooks are not available yet. Poll /api/v1/recommendations or use updated_since on /api/v1/products to pick up changes.

SDKs & Libraries

There are no official SDKs yet. Generate a client for your language from openapi.yaml with any OpenAPI generator. Packages on public registries that claim to be a Price Monitor SDK are not from us.

API Documentation