Reef AI: ask for any data. Try it
PriceSpy UK & NZ API

Every UK and New Zealand shop's price for a product, with shipping and its price history

endpoints
5
credits per call
1–2

PriceSpy is Prisjakt's price comparison service for the United Kingdom (pricespy.co.uk, prices in GBP) and New Zealand (pricespy.co.nz, prices in NZD), and this API reads both as JSON, chosen with `country` (uk by default, or nz).

/pricespy/v1

  • POST/pricespy/v1/search2 credits
  • POST/pricespy/v1/category1 credit
  • POST/pricespy/v1/product1 credit
  • POST/pricespy/v1/offers1 credit
  • POST/pricespy/v1/price_history2 credits
5 active endpoints, on 1 and 2 credit tiers.Every parameter ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

PriceSpy UK & NZ API

5 of 5 endpoints, ready to run

View docs ↗

Find products on PriceSpy UK or New Zealand, with category, brand and rating facets

2 credits1 required · 1 optional
POST/pricespy/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What PriceSpy UK & NZ endpoints does ReefAPI ship?

5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    2 cr

    Keyword search on PriceSpy UK or New Zealand.

    required
    query
    optional
    country, category_filter, brand_id, rating, in_stock_only, sort, page
  • category

    1 cr

    One PriceSpy category listing (UK or New Zealand).

    required
    category_id
    optional
    country, brand_id, sort, page
  • product

    1 cr

    One product on PriceSpy UK or New Zealand.

    required
    product_id
    optional
    country
  • offers

    1 cr

    Every shop offer for one product on PriceSpy UK or New Zealand, cheapest first.

    required
    product_id
    optional
    country
  • price_history

    2 cr

    PriceSpy's price chart for one product in the UK or New Zealand.

    required
    product_id
    optional
    country, time_range

Every parameter, every allowed value →

Missing a PriceSpy UK & NZ endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the PriceSpy UK & NZ API works

PriceSpy UK & NZ is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

Call02
POST /pricespy/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a keyword to every UK or New Zealand shop's price and the price curve

Search PriceSpy UK or New Zealand, pick the products, then read their offer lists and price history. This is the same data as /prisjakt-api with the market fixed to the UK or New Zealand; calls to POST /prisjakt/v1/... with country uk or nz keep working unchanged.

01search?query=iphone%2016&country=uk
GET/pricespy/v1/search?query=iphone%2016&country=uk

Products with product_id, lowest price in GBP, offer count and rating, plus category, brand and rating facets with ids and counts.

02offers?product_id=<product_id>&country=uk
GET/pricespy/v1/offers?product_id=<product_id>&country=uk

Every UK offer: condition, price, shipping, price including shipping, delivery days where the shop states them, stock and the link to the shop.

03price_history?product_id=<product_id>&country=uk&time_range=1y
GET/pricespy/v1/price_history?product_id=<product_id>&country=uk&time_range=1y

Each change of the lowest price with its date and the shop that set it.

04offers?product_id=<product_id>&country=nz
GET/pricespy/v1/offers?product_id=<product_id>&country=nz

The same product in New Zealand: the id is shared, prices are in NZD and the shops are New Zealand shops.

A dated price feed per product for the UK and New Zealand: the lowest price, every competing shop with shipping where published, and the history of who was cheapest when.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "pricespy",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a PriceSpy field actually contains

Fields that read differently from how they look. Every row was measured against live PriceSpy UK and New Zealand responses on 2026-11-22.

FieldWhat it holds
countryuk = pricespy.co.uk, prices in GBP; nz = pricespy.co.nz, prices in NZD. Omitted = uk. Other Prisjakt markets (Sweden, Norway, Finland) are not accepted here; they are on /prisjakt-api.
product_idPriceSpy's product number, the p= in product.php?p=13854649, returned as an integer. It is the same product in the UK and New Zealand (13854649 is Apple iPhone 16 128GB in both); prices, shops and currency follow `country`.
lowest_priceThe product's headline "from" price for new items in the market's currency: 520.99 GBP in the UK and 1,615 NZD in New Zealand for the iPhone 16 128GB on 2026-11-22. It is null for products listed without a live offer (12 of 48 New Zealand search rows for "iphone 16").
lowest_price_any_conditionThe lowest price including used and refurbished offers: 389.49 GBP in the UK and 1,001 NZD in New Zealand for the same product.
shipping_cost, price_incl_shippingThe shop's shipping cost and its price including shipping. In the UK 19 of 24 offers published them, and price plus shipping equalled the price including shipping on all 19. In New Zealand both were null on all 17 offers measured; never estimated.
delivery_days_min, delivery_days_max, carrierOnly where the shop states them: 3 of 24 UK offers (Royal Mail, 1 to 4 days) and none of the New Zealand offers measured.
shopThe shop's id, name, country, whether it is a marketplace and its PriceSpy page. UK offers came from 17 shops (shop country gb on 23 of 24, 4 marketplaces); New Zealand offers from 7 shops, all nz. The shop rating was empty on all 32 offers measured.
total, matching_totalPriceSpy lists at most 1000 products per search (total). matching_total is PriceSpy's own match count: 1,369 for "iphone 16" in New Zealand.
price_history.pointsOne point per change of the lowest price: the date, the price, the shop that set it and that shop's own title for the offer. The price holds until the next point.

Prices are in GBP for the UK and NZD for New Zealand, as PriceSpy publishes them. The market is chosen with country, not by where you call from.

Coverage

PriceSpy UK and New Zealand coverage, measured

Every number below was read from live PriceSpy responses on 2026-11-22 (12 calls, all ok).

Markets and currency

pricespy.co.uk returns prices in GBP and pricespy.co.nz in NZD: 48 of 48 search rows for "iphone 16" carried the market's currency and a link on that market's own domain, in both markets.

UK search and category

"iphone 16" on PriceSpy UK returned 48 products per page from 6.44 to 1,798.98 GBP (1000 listable per query); the UK mobile phones category (103) held 2,828 products, 24 per page.

New Zealand search and category

"iphone 16" on PriceSpy New Zealand matched 1,369 products, 48 per page from 14.98 to 2,771 NZD; 12 of the 48 had no current price. The New Zealand mobile phones category held 607 products.

UK offers

The Apple iPhone 16 128GB had 24 UK offers from 17 shops (Argos, Currys, Amazon.co.uk, eBay, CeX and others), 389.49 to 799 GBP: 14 new, 7 refurbished, 3 used. 19 of 24 published a shipping cost and price plus shipping equalled the price including shipping on all 19; delivery days came on 3 of 24.

New Zealand offers

The same product had 8 New Zealand offers from 7 shops (Noel Leeming, JB Hi-Fi, PB Tech and others), 1,000.99 to 1,920 NZD. New Zealand shops published no shipping cost and no delivery days on any of 17 offers measured on two products.

Price history

One year of the iPhone 16's lowest price: 115 changes in the UK (lowest 270 GBP, 53 shops) and 74 in New Zealand (lowest 1,370.72 NZD, 15 shops), each with the date and the shop.

Product details

product returned the brand, category path, 6 variants with their GTINs, 75 spec rows, the lowest, any-condition and highest price, offer and shop counts, rating and popularity rank, in both markets.

Limits

Shop ratings were empty on all 32 offers measured; the description and release date were empty on the product measured; search lists at most 1000 products per query; review texts are not returned.

Use cases

What people build with PriceSpy UK & NZ

The jobs this data is most often used for.

01

Track the lowest price and every UK or New Zealand shop's price, with shipping where published, for a product list.

02

Pull PriceSpy's price history to see when and at which shop a product was cheapest in the UK or New Zealand.

03

Compare one product's price between the UK and New Zealand with a single product_id.

04

Map a UK or New Zealand category's catalogue with prices, ratings, popularity rank and GTIN codes.

5

endpoints

1/2

credits per call

Pricing

What PriceSpy UK & NZ data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 746 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/pricespy/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "iphone 16",
        "country": "uk"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up PriceSpy UK & NZ.

Is there a PriceSpy API?▾

Yes: this API reads PriceSpy UK and PriceSpy New Zealand as JSON, with search, category listings, product details, every shop offer and the price history. It needs no PriceSpy account; everything is read logged out.

Which countries does it cover?▾

The United Kingdom (pricespy.co.uk, GBP) and New Zealand (pricespy.co.nz, NZD); pick one with country, uk by default. Sweden, Norway and Finland are on the Prisjakt API at /prisjakt-api.

Which currency are the prices in?▾

GBP for the UK and NZD for New Zealand: 48 of 48 search rows carried the market's currency in both markets on 2026-11-22.

How many shops does offers return?▾

All the offers PriceSpy lists for the product, in one call: 24 UK offers from 17 shops and 8 New Zealand offers from 7 shops for the Apple iPhone 16 128GB on 2026-11-22.

Is shipping included?▾

In the UK, each offer has the price, the shipping cost and the price including shipping when the shop publishes them, which 19 of 24 offers did. In New Zealand no shop published a shipping cost on the 17 offers measured, so those fields are null.

Does it return the shop that sells each offer?▾

Yes. Every offer names the shop, its country, whether it is a marketplace and links to it (Argos, Currys, Amazon.co.uk and eBay in the UK; Noel Leeming, JB Hi-Fi and PB Tech in New Zealand). The shop rating was empty on every offer measured.

How far back does price_history go?▾

Choose 3m, 6m, 1y, 2y or all. For the iPhone 16, one year held 115 price changes in the UK and 74 in New Zealand, each with the date and the shop.

Is this different from the Prisjakt API?▾

It is the same data as /prisjakt-api with the market fixed to the UK or New Zealand, at the same price. Calls to POST /prisjakt/v1/... with country uk or nz keep working unchanged.

Do you return user reviews?▾

Not yet. product returns the rating and number of ratings; review texts are not returned.

What is the PriceSpy UK & NZ API?▾

PriceSpy UK & NZ API is a ReefAPI endpoint group for pricespy uk and new zealand price comparison: every shop's price with shipping, the price history chart, specs and gtins, in gbp and nzd. It returns live JSON through POST requests under /pricespy/v1.

Is the PriceSpy UK & NZ API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. PriceSpy UK & NZ calls use the same shared credit balance as every other ReefAPI engine.

Do I need a PriceSpy UK & NZ login or account?▾

No login to PriceSpy UK & NZ is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the PriceSpy UK & NZ data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the PriceSpy UK & NZ API use?▾

PriceSpy UK & NZ actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-22.