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/v1v1At 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 set
data[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"
}
]
}- QuickstartFrom API key to competitor prices in about five minutes.
- Scheduled syncLook up every SKU nightly and write each competitor listing's price and freshness to your system or a CSV.
- API referenceEvery endpoint, parameter, response and error.
- Errors and rate limitsWhat each error code means and how to retry safely.
| You want to | Call |
|---|---|
| Check that your key works | GET /v1/me |
| Get competitor prices for up to 100 SKUs | GET /v1/comparison-sets?sku=…&sku=… |
| Sync every comparison set into your ERP | GET /v1/comparison-sets |
| Get one comparison set | GET /v1/comparison-sets/{set_id} |
| Find one of your products to link a SKU | GET /v1/products?q=… |
| See which competitors GetPrice tracks for you | GET /v1/competitors |
| Link or unlink your SKUs | PUT 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.