PriceSpy UK & NZ
PriceSpy UK and New Zealand price comparison: every shop's price with shipping, the price history chart, specs and GTINs, in GBP and NZD.
/pricespy/v1/search2 creditsKeyword search on PriceSpy UK or New Zealand. Rows are catalogue products (lowest price, number of offers, rating, category) and, mostly in price-sorted searches, single-shop items PriceSpy has not matched to a product (`row_type: offer`, with the shop and a link to it). Filter by category and brand (ids from the facets this action returns), rating bucket and in-stock. At most 1000 products per query (`total`); the true match count is `matching_total`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words, e.g. `iphone 16`, `dammsugare`, `coffee machine`. |
| country = uk | optional | uk · nz | Which PriceSpy market: uk = pricespy.co.uk (United Kingdom, prices in GBP), nz = pricespy.co.nz (New Zealand, prices in NZD). Product ids are shared by both markets; prices, shops and currency come from the market chosen. Omitted = uk. |
| category_filter | optional | — | Category facet id from `category_facets` (e.g. `pc:horlurar`). An unknown id returns no rows. |
| brand_id | optional | — | Brand id from `brand_facets` (e.g. 142 = Apple). An unknown id returns no rows. |
| rating | optional | 1 · 2 · 3 · 4 | Rating bucket: products whose user rating is N.x (4 = 4.0-4.99). From `rating_facets`. |
| in_stock_only = false | optional | — | Only products some shop has in stock. |
| sort = relevance | optional | relevance · popularity · price_asc · price_desc | Result order. |
| page = 1 | optional | 1–21 | Result page, 48 rows per page; the source serves at most 21 pages. |
/pricespy/v1/category1 creditOne PriceSpy category listing (UK or New Zealand): every product in the category with its lowest price, lowest price including shipping, number of offers, rating and popularity rank, 24 per page. Filter by brand; sort by popularity, price, price including shipping, user-review ranking or name.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category_id | required | — | Numeric Prisjakt category id: `category.category_id` of `product`, a search row's `category.id`, `categories[]` of `search`, or the number in kategori.php?k=<id> (103 = Mobiltelefoner / Mobile phones). |
| country = uk | optional | uk · nz | Which PriceSpy market: uk = pricespy.co.uk (United Kingdom, prices in GBP), nz = pricespy.co.nz (New Zealand, prices in NZD). Product ids are shared by both markets; prices, shops and currency come from the market chosen. Omitted = uk. |
| brand_id | optional | — | Numeric brand id (e.g. 142 = Apple). |
| sort = popularity | optional | popularity · price_asc · price_desc · price_incl_shipping_asc · user_reviews · name | Result order. |
| page = 1 | optional | 1–500 | Result page, 24 products per page. |
/pricespy/v1/product1 creditOne product on PriceSpy UK or New Zealand: title, brand, category path, image, release date, the lowest price (new) and lowest in any condition, the highest price, number of offers and shops, user rating, popularity rank, every variant with its GTIN / EAN, and the full spec sheet.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | 1– | Prisjakt product id: the `product_id` of a search / category row, or the number in a product URL (…/produkt.php?p=<id>). The same id works on every market. |
| country = uk | optional | uk · nz | Which PriceSpy market: uk = pricespy.co.uk (United Kingdom, prices in GBP), nz = pricespy.co.nz (New Zealand, prices in NZD). Product ids are shared by both markets; prices, shops and currency come from the market chosen. Omitted = uk. |
/pricespy/v1/offers1 creditEvery shop offer for one product on PriceSpy UK or New Zealand, cheapest first: shop (name, rating, marketplace, country), condition, price, shipping cost, price including shipping, delivery days, stock status and the link to the shop. Shipping and the price including shipping are null where the shop publishes no shipping cost.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | 1– | Prisjakt product id: the `product_id` of a search / category row, or the number in a product URL (…/produkt.php?p=<id>). The same id works on every market. |
| country = uk | optional | uk · nz | Which PriceSpy market: uk = pricespy.co.uk (United Kingdom, prices in GBP), nz = pricespy.co.nz (New Zealand, prices in NZD). Product ids are shared by both markets; prices, shops and currency come from the market chosen. Omitted = uk. |
/pricespy/v1/price_history2 creditsPriceSpy's price chart for one product in the UK or New Zealand: every change of the lowest price with its date and the shop that set it, 3 months to all time.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | 1– | Prisjakt product id: the `product_id` of a search / category row, or the number in a product URL (…/produkt.php?p=<id>). The same id works on every market. |
| country = uk | optional | uk · nz | Which PriceSpy market: uk = pricespy.co.uk (United Kingdom, prices in GBP), nz = pricespy.co.nz (New Zealand, prices in NZD). Product ids are shared by both markets; prices, shops and currency come from the market chosen. Omitted = uk. |
| time_range = 1y | optional | 3m · 6m · 1y · 2y · all | How far back. |
curl -X POST https://api.reefapi.com/pricespy/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 16","country":"uk"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.