Primat API

# A one-hour tryout key in one call:
curl -X POST https://primat.nu/api/v3/signup \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com"}'

# Which stores serve a place? The site's own resolver:
curl -H 'Authorization: Bearer <key>' \
  'https://primat.nu/api/v3/stores/resolve?place=Uppsala'

# Prices for a product at those stores:
curl -H 'Authorization: Bearer <key>' \
  'https://primat.nu/api/v3/products?q=banan&stores=ica:1003385'

The tryout key works for one hour on a tight quota. Ongoing access starts with a 30-day free App trial (card required; 249 SEK/month ex VAT after the trial, cancel anytime): log in at primat.nu/data with the same address, and the key keeps working once the trial starts. Machine-readable contract: https://primat.nu/api/v3/openapi.json — self-describing root: /api/v3.

Authorization: Bearer <key> or X-API-Key: <key>. Two key types: secret (primat_live_…, server-side) and publishable (primat_pk_…, safe to embed in client-side apps: locked to your web origins, read-only, own quota, CORS enabled). Manage keys at primat.nu/konto.

• GET /api/v3 no key Self-describing API directory.
• GET /api/v3/openapi.json no key This document.
• POST /api/v3/signup no key Instant tryout key, no email round-trip: valid one hour; ongoing access starts with a 30-day App trial. Body: {"email": "you@example.com"}. Returns 201 with the key (shown once). The key is a one-hour tryout: 60 req/min, 2,000 rows/day plus a shared global pool. Ongoing access: the account owner logs in at https://primat.nu/data with this address and starts the 30-day free App trial (card required; 249 SEK/month ex VAT after the trial, cancel anytime); the key then runs on App quotas (250 req/min, 100,000 rows/day). One tryout per address: a repeat signup answers 402 tryout_used. 409 if the address already has an established account.
• POST /api/v3/confirm/request Email the account owner the link to start the 30-day App trial. Authenticate with the tryout key while it is valid. Rate-limited (3/day per key). The mail links https://primat.nu/data, where the owner logs in with the signup address and starts the trial; the key then runs on App quotas.
• GET /api/v3/me Account, plan limits (from the entitlement matrix) and usage today for the presented key.
• GET /api/v3/stores Store register with coverage tier and confirmed_at. Free on every plan: store lookups don't count toward rows/day.
• GET /api/v3/stores/resolve Place -> ranked nearby stores + the site's own default store selection. Give ONE of: place= (locality name or 5-digit postcode), postcode=, or lat=&lon=. The default_selection is exactly what the consumer site would pick for that visitor — use it directly as the stores= parameter. Free on every plan: store lookups don't count toward rows/day.
• GET /api/v3/products Ranked product search. With stores=: every carrying (store, product) row in your stores. Without: one row per product at its cheapest carrying store nationally. For FULL store catalogs use /api/v3/prices (keyset pages) — search is ranked and bounded, it does not paginate.
• GET /api/v3/products/{chain}/{store_id}/{product_id} One product at one store.
• GET /api/v3/prices Full store catalogs as keyset cursor pages. The bulk surface: every current price row for up to 15 stores, paged with an opaque keyset cursor over (product_id, chain, store_id) — pages are stable, never skip or duplicate a row, and interleave the same product across your stores for easy comparison. Follow next_cursor until null.
• GET /api/v3/deals Current price drops with prices.previous and discount_ratio.
• GET /api/v3/cheap Cheapest products by comparison (unit) price.
• POST /api/v3/batch Up to 100 product lookups in one call (every plan; response bounded by your plan's per-call row cap). Body: {"lookups": [{"gtin": "7310865093530"} | {"chain": "willys", "store_id": "2103", "product_id": "100302995_ST"} | {"chain": "willys", "product_id": "100302995_ST"}], "stores": "willys:2103,..." (optional scope)}. GTIN lookups return every matching chain; without a store scope each chain answers with its cheapest carrying store.
• GET /api/v3/history/{chain}/{store_id}/{product_id} Daily price-change history for one product at one store. Paid tiers — Pro: generation-pinned 12 months. Byrå: full history (since Dec 2025). Deep reads are pinned to a committed history generation and time-budgeted (504 history_timeout on overruns).
• GET /api/v3/history/{gtin} History across carrying stores by GTIN/EAN (up to 6 series). Default: each chain's cheapest carrying store. Scope explicitly with stores= (max 6).

Price FACTS. regular: what everyone pays (public campaigns included). member: only set while a member price runs. multiprice/member_multiprice: PER-UNIT price when buying `quantity` (7 with quantity 5 = '5 for 35 kr'). comparison: unit price per kg/l/st computed on the REGULAR price. offer: the active campaign behind the current pricing, null when none. effective: least price a card-carrying shopper pays right now (a convenience fold; combine the facts yourself for anything serious). previous: on /deals results.

Fields: regular, member, multiprice, member_multiprice, comparison, offer, effective, previous. Timestamps: changed_at = when the price last CHANGED, confirmed_at = when the store was last checked. No change since changed_at means confirmed unchanged, not unmeasured.

Every non-2xx answer is {"error": {"code", "message"}} with honest Retry-After/WWW-Authenticate headers. Codes: invalid_api_key, rate_limited, daily_row_budget_exceeded, query_required, bad_request, not_found, product_not_found, place_not_found, upgrade_required, trial_required, tryout_expired, tryout_used, origin_not_allowed, read_only_key, email_in_use, invalid_email, signup_limit_reached, history_timeout, service_unavailable.

Questions, bulk exports (CSV/Parquet, Byrå plan), or something missing? kontakt@primat.nu.