Skip to content

GetPrice API

Look up competitor prices for your own SKUs and feed them into your ERP, BI or pricing tools. Send a SKU, and the GetPrice API returns every competitor selling that item, with each price and when GetPrice last collected it.

https://api.getprice.ai/v1v1

At a glance

You send a secret key in the Authorization header. Everything is JSON over HTTPS, at https://api.getprice.ai/v1. Money is a decimal string with a currency, and times are UTC. Lists come in pages that you follow with next_cursor.

BASE=https://api.getprice.ai/v1
curl -G "$BASE/comparison-sets" \
  -H "Authorization: Bearer $GETPRICE_API_KEY" \
  --data-urlencode "sku=TV-55UHD" \
  --data-urlencode "sku=TEA-RB80-C12" \
  --data-urlencode "sku=KTL-17-SS"
import os

import requests

BASE = "https://api.getprice.ai/v1"
KEY = os.environ["GETPRICE_API_KEY"]

resp = requests.get(
    f"{BASE}/comparison-sets",
    params=[
        ("sku", "TV-55UHD"),
        ("sku", "TEA-RB80-C12"),
        ("sku", "KTL-17-SS"),
    ],
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=30,
)
resp.raise_for_status()
page = resp.json()
for entry in page["skus"]:
    print(entry["sku"], entry["status"])
for cset in page["data"]:
    for entry in cset["competitors"]:
        price = entry["price"]
        if price:
            name = entry["competitor"]["name"]
            print(cset["sku"], name, price["amount"])
interface Entry {
  competitor: { name: string };
  price: { amount: string } | null;
}
interface Page {
  data: { sku: string | null; competitors: Entry[] }[];
  skus: { sku: string; status: string }[];
}

const BASE = "https://api.getprice.ai/v1";
const KEY = process.env.GETPRICE_API_KEY;
const params = new URLSearchParams([
  ["sku", "TV-55UHD"],
  ["sku", "TEA-RB80-C12"],
  ["sku", "KTL-17-SS"],
]);
const url = `${BASE}/comparison-sets?${params}`;
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${KEY}` },
});
if (!res.ok) {
  throw new Error(`GetPrice returned ${res.status}`);
}
const page = (await res.json()) as Page;
for (const { sku, status } of page.skus) {
  console.log(sku, status);
}
for (const set of page.data) {
  for (const { competitor, price } of set.competitors) {
    if (!price) continue;
    console.log(set.sku, competitor.name, price.amount);
  }
}
<?php
$base = "https://api.getprice.ai/v1";
$key = getenv("GETPRICE_API_KEY");
// Repeat sku once per SKU.
$skus = ["TV-55UHD", "TEA-RB80-C12", "KTL-17-SS"];
$query = implode("&", array_map(
    fn ($sku) => "sku=" . rawurlencode($sku),
    $skus,
));
$ch = curl_init("$base/comparison-sets?$query");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $key",
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($body === false || $status >= 400) {
    throw new RuntimeException(
        "GetPrice returned $status: $body"
    );
}
$data = json_decode(
    $body, true, flags: JSON_THROW_ON_ERROR
);

foreach ($data["skus"] as $entry) {
    echo $entry["sku"], " ", $entry["status"], "\n";
}
foreach ($data["data"] as $set) {
    foreach ($set["competitors"] as $entry) {
        if ($entry["price"] === null) {
            continue;
        }
        echo $set["sku"], " ",
            $entry["competitor"]["name"], " ",
            $entry["price"]["amount"], "\n";
    }
}
using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Json;
using Naming = System.Text.Json.JsonNamingPolicy;

var key = Environment.GetEnvironmentVariable(
    "GETPRICE_API_KEY");
var api = new Uri("https://api.getprice.ai/v1/");
var http = new HttpClient { BaseAddress = api };
http.Timeout = TimeSpan.FromSeconds(30);
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", key);
var json = new JsonSerializerOptions
{
    PropertyNamingPolicy = Naming.SnakeCaseLower,
};

var res = await http.GetAsync(
    "comparison-sets?sku=TV-55UHD&sku=TEA-RB80-C12"
    + "&sku=KTL-17-SS");
res.EnsureSuccessStatusCode();
var page = await res.Content
    .ReadFromJsonAsync<Page>(json);
foreach (var s in page!.Skus)
    Console.WriteLine($"{s.Sku} {s.Status}");
foreach (var set in page.Data)
    foreach (var e in set.Competitors)
        if (e.Price is { } price)
            Console.WriteLine(
                $"{set.Sku} {e.Competitor.Name} "
                + price.Amount);

record Page(List<CompSet> Data, List<SkuStatus> Skus);
record SkuStatus(string Sku, string Status);
record CompSet(string? Sku, List<Entry> Competitors);
record Entry(Competitor Competitor, Price? Price);
record Competitor(string Name);
record Price(string Amount);
First comparison setdata[0]200
{
  "id": "set_x7Kp2Lm9",
  "name": "55-inch 4K UHD Smart TV",
  "sku": "TV-55UHD",
  "competitors": [
    {
      "competitor": { "name": "Kestrel Electronics" },
      "price": {
        "amount": "8499.00",
        "was": "9499.00",
        "currency": "ZAR"
      },
      "last_collected_at": "2026-11-02T03:05:11Z"
    }
  ]
}

Full example in the reference

You want toCall
Check that your key worksGET /v1/me
Get competitor prices for up to 100 SKUsGET /v1/comparison-sets?sku=…&sku=…
Sync every comparison set into your ERPGET /v1/comparison-sets
Get one comparison setGET /v1/comparison-sets/{set_id}
Find one of your products to link a SKUGET /v1/products?q=…
See which competitors GetPrice tracks for youGET /v1/competitors
Link or unlink your SKUsPUT or DELETE /v1/sku-mappings/{sku}

Prices are read-only. The only thing you can change is which of your SKUs points at which of your products.

A SKU here is your own product code: the stock code, item code or ERP reference your systems already use.