Notivo

Overview

This API allows your store to pull the latest market price and the smart pricing value generated by the system.

Each token can have its own rate limit; exceeded limits return HTTP 429.

Base URL

/api/v1

Authorization

Bearer token or X-API-KEY header

Authentication

Create tokens in Settings → API access. Tokens are scoped and rate-limited. Keep them secret.

Required scope for price export: prices:read

Authorization: Bearer <TOKEN>
X-API-KEY: <TOKEN>

Endpoints

GET /api/v1/prices?ids=1,2,3

Return prices for a list of track IDs.

curl -H "Authorization: Bearer <TOKEN>" \
  "https://your-domain.com/api/v1/prices?ids=12,15,18"

GET /api/v1/prices/{track_id}

Return a single track price by ID.

curl -H "Authorization: Bearer <TOKEN>" \
  "https://your-domain.com/api/v1/prices/12"

Response fields

track_id

Track ID in the system.

market_price

Last price seen on the marketplace.

smart_price

Smart pricing value generated by the system.

last_checked_at

Timestamp of the last successful check.

price_tracked

True if price was successfully parsed.

unavailable_reason

Reason when price is not available (e.g. http_404, price_missing, out_of_stock, blocked_by_protection).

Smart pricing behavior

If smart pricing is disabled, smart_price is null.
If mode is auto, smart_price equals the latest auto-adjusted price (user_price) when available.
If mode is recommend, smart_price equals the latest recommendation value.
The API returns the last computed value; it is updated by scheduled checks, not by API calls.

Example response

{
  "data": {
    "track_id": 12,
    "market_price": 1299.99,
    "currency": "UAH",
    "last_checked_at": "2026-01-27T11:42:19+00:00",
    "price_tracked": true,
    "unavailable_reason": null,
    "unavailable_at": null,
    "smart_price": 1259.99,
    "smart_pricing": {
      "enabled": true,
      "mode": "auto",
      "percent": -3,
      "floor": null,
      "last_status": "auto"
    }
  }
}

Errors

401 Unauthorized — missing or invalid token

403 Forbidden — token lacks required scope

404 Not Found — track not found

422 Unprocessable Entity — ids parameter is required

429 Too Many Requests — rate limit exceeded

API Documentation

Get an API token