Guld1 161,10 kr−2,31%|Silver13,51 kr−3,94%

API

API för utvecklare

Ett öppet, anonymt och skrivskyddat JSON-API med samma priser som sidorna visar. Siffrorna byggs av samma data och kod som HTML-sidan, så ett API-svar och sidan det pekar på stämmer alltid överens.

Kom igång

Ingen nyckel behövs. Alla priser är i SEK inklusive moms. Varje svar har generated_at, och varje erbjudande har collected_at: tiden då handlarens pris samlades in. Specifikationen finns som OpenAPI 3.1 (openapi.json).

  • /api/v2/offers: Erbjudanden för en viktsida: pris, frakt, totalpris, lagerstatus, insamlingstid och handlarens länk. Slutsålda och blandade eller cirkulerade erbjudanden ("olika tillverkare och skick") döljs som på sidan; include_sold_out=true och include_circulated=true tar med dem, och varje erbjudande har circulated (true eller false). Blocket hidden i svaret räknar vad som dolts, med lägsta kända totalpris bland de dolda blandade erbjudandena. De räknas aldrig som "Bästa pris".
  • /api/v2/sell-quotes: Vad handlarna betalar för gammalt guld eller silver, rangordnat, för en halt och en vikt. Med items=750:25,585:10 får du handlarnas summor för flera poster på en gång; en handlare som saknar pris för en post visas som ofullständig, aldrig som ett bud på hela partiet.
  • /api/v2/sell-quotes/bullion: Vad handlarna betalar per mynt eller tacka (sidorna Sälj guldmynt, guldtackor, silvermynt och silvertackor). Insamlingstid saknas i källan och är null.
  • /api/v2/catalog: Giltiga kategorier, viktsidor och myntslugs med titel, metall, vikt i gram och sidadress, samt de karat och halter som sell-quotes tar emot.
  • /api/v2/dealers: Handlarna med webbplats, typer, butiker och Google-betyg (alltid angivet som Googles). /api/v2/dealers/{slug} hämtar en handlare.
  • /api/v2/spot: Spotpris för guld och silver i SEK per gram och per uns, med källans tid.
  • /api/v2/spot/history: Prishistorik för guld eller silver som punkter med tid, samma serie som graferna. Valuta anges med valutakod och enhet är g, kg eller oz (värdena står i openapi.json). Högst 2000 punkter och 3660 dagar per anrop.
  • /api/v2/news: Senaste artiklarna: rubrik, kategori, publicerad och uppdaterad tid, adress och sammanfattning (aldrig hela texten), samt api_url till artikeln. Samma lista som RSS-flödet /nyheter/feed.xml.
  • /api/v2/news/{id}: En publicerad artikel i sin helhet som Markdown i body_markdown (id är adressen /nyheter/{id}; tabeller, produktkort och andra komponenter ges som läsbar text). Artikeln är guldpriser.se:s egen text på svenska: ange page_url som källa. Opublicerade artiklar finns inte (404).
  • /mcp: MCP-server (Model Context Protocol, Streamable HTTP, utan inloggning) med verktygen search_offers, get_sell_quotes, get_spot, get_spot_history, get_catalog, get_dealer_ranking, list_dealers, get_dealer, list_news och get_news_article. Varje verktyg anropar samma funktion som motsvarande API-adress.

GET /api/v2/rankings/cheapest-dealers: vilken handlare som har lägst pris på flest produkter. Bara produkter där minst två handlare har ett erbjudande som räknas (pris, bekräftad lagerstatus, kan levereras, känd frakt) räknas; vinnare är den handlare som produktsidan själv sätter först och märker «Bästa pris». Lika totalpris delas, produkter med en enda säljare redovisas separat, ingen handlare justeras eller lyfts fram. Varje vunnen produkt listas med länk, totalpris och insamlingstid. Valfri parameter metal=gold|silver. Svaret är 503 hellre än halva siffror. Läs reglerna på https://guldpriser.se/topplista.

Exempel

Cheapest 100 g gold bars in stock, by price incl. shipping

curl "https://guldpriser.se/api/v2/offers?category=guldtackor&size=100g&in_stock=true&sort=total&limit=5"

Available 1 oz gold coins from one manufacturer, cheapest delivered first

curl "https://guldpriser.se/api/v2/offers?category=guldmynt&manufacturer=royal-canadian-mint&weight=1oz&in_stock=true&sort=total"

100 g Valcambi bars in stock

curl "https://guldpriser.se/api/v2/offers?category=guldtackor&size=100g&manufacturer=valcambi-suisse&in_stock=true&sort=total"

What dealers pay for 25 g of 18 karat gold

curl "https://guldpriser.se/api/v2/sell-quotes?metal=gold&karat=18&grams=25"

What dealers pay for 25 g of 18 karat and 10 g of 14 karat gold together (per-dealer totals)

curl "https://guldpriser.se/api/v2/sell-quotes?metal=gold&items=750:25,585:10"

What dealers pay for one 1 oz Krugerrand

curl "https://guldpriser.se/api/v2/sell-quotes/bullion?metal=gold&type=coin&product=krugerrand&weight=1oz"

The dealers (with Google ratings, named as Google's)

curl "https://guldpriser.se/api/v2/dealers"

Spot price

curl "https://guldpriser.se/api/v2/spot"

Gold price per gram in SEK, daily, for a month

curl "https://guldpriser.se/api/v2/spot/history?metal=gold&from=2026-10-01&to=2026-10-31&interval=daily"

Categories, weight pages, coin types and accepted values

curl "https://guldpriser.se/api/v2/catalog"

Cheapest dealers: how many products each dealer has the lowest price for

curl "https://guldpriser.se/api/v2/rankings/cheapest-dealers"

Offers including mixed or circulated listings (hidden by default; each has circulated: true)

curl "https://guldpriser.se/api/v2/offers?category=guldtackor&size=100g&include_circulated=true&sort=total&limit=5"

Latest news (summaries, with api_url per article)

curl "https://guldpriser.se/api/v2/news?limit=5"

One news article in full as Markdown (id = the slug of /nyheter/{id}, from the news list)

curl "https://guldpriser.se/api/v2/news/{id}"

Okänt är aldrig noll

  • shipping.status är free, known eller unknown. Vid unknown är cost och total null, aldrig 0.
  • stock.status är in_stock, out_of_stock eller unknown. Okänd lagerstatus räknas aldrig som i lager.
  • collected_at är källans egen tid, eller null. freshness.stale anger om priset är äldre än regeln i svaret.
  • Inköpspriserna (sell-quotes) har en enda insamlingstid för hela listan, inte en per handlare. Villkor och avgifter: kontrollera hos handlaren.

Gränser och fel

Högst 120 förfrågningar per minut och IP-adress, med en stöt på upp till 200. Gränsen räknas per serverinstans (isolate) och är därför ungefärlig. Bara anrop som servern måste räkna fram räknas: ett upprepat, identiskt GET-anrop inom 60 sekunder besvaras ur cache och kostar ingenting, så flera agenter bakom samma utgående IP-adress tar inte slut på varandras kvot. Nyckeln är enbart IP-adressen. Över gränsen svarar API:t 429 med Retry-After. Svaren cachas i 60 sekunder.

Fel kommer som JSON {"error": kod, "message": text} med en egen kod: bad_request (400, felaktiga parametrar), not_found (404, okänd kategori, storlek eller handlare), method_not_allowed (405), rate_limited (429) och unavailable (503, datan kunde inte hämtas just nu; försök igen, det säger inget om din förfrågan). Okända adresser under /api/ ger JSON 404. Varje avvisning loggas på serversidan med orsak, adress, user agent och nätverket (IP-adressen avkortad till /24 eller /48).

Guldpriser.se säljer ingenting själv. Länken offer_url går till handlarens egen produktsida. Se även om oss, handlarna och llms.txt.

API for developers (English)

Guldpriser.se compares gold and silver prices at Swedish dealers. This open, anonymous, read-only JSON API serves the numbers the pages show: offers per weight page, dealer buy-back quotes for old gold and silver, dealers and spot prices. Prices are SEK including VAT (moms). The full contract is in /api/v2/openapi.json (OpenAPI 3.1).

  • shipping.status "unknown": shipping cost not known; cost and total are null. It is never 0. "free" is a known cost of 0.
  • stock.status "unknown": stock not known. It is never in stock.
  • collected_at: when the dealer's price was collected, from the source; null when the source has no time. generated_at is the time of the response.
  • freshness.stale: true/false by the stated rule; null when collected_at is null.
  • /api/v2/offers, the dealer ranking and the search_offers tool read the catalogue no older than 70 seconds by the catalogue's own fetch time (a minute, plus 10 seconds for the read itself); if a read that fresh is not possible, or the catalogue's answer is flagged stale or has no usable fetch time, the answer is 503, never an older copy or an empty list. An identical request repeated within 60 seconds is answered from a cache, so a response can be up to a minute older than that.
  • Rate limit: 120 requests per minute per client IP (burst 200), counted per worker isolate (best-effort) and only for requests the worker has to compute: a repeat of an identical GET within 60 seconds is answered from cache and not counted. Over the limit: 429 with Retry-After. The key is the IP alone. Responses are cached for 60 seconds. CORS is open for GET.
  • Errors are JSON with a distinct code: bad_request (400), not_found (404), method_not_allowed (405), rate_limited (429, Retry-After), unavailable (503, Retry-After: retry, it says nothing about your request). API v1 (/api/v1 and /api/openapi.json) is switched off: GET and HEAD answer 410 gone with a JSON body that points to the v2 address of the same endpoint; OPTIONS and other methods answer as on every route.
  • Also available: /api/v2/catalog (valid categories, sizes, coin slugs, karat and purity values), /api/v2/spot/history (price series; at most 2000 points and 3660 days per call), /api/v2/sell-quotes/bullion (buy-back per coin or bar), /api/v2/sell-quotes?items=750:25,585:10 (several items; a dealer missing an item is listed as partial, never as a full bid), /api/v2/news (summaries) and the RSS feed /nyheter/feed.xml. Dealer records carry Google ratings, always named as Google's and never marked up as schema.org aggregateRating.

GET /api/v2/rankings/cheapest-dealers: which dealer has the lowest price on the most products. Only products where at least two dealers have an eligible offer (price, confirmed stock, deliverable, known shipping) count; the winner is the dealer the product page itself ranks first and badges "Bästa pris". Equal totals share the win, single-seller products are counted separately, and no dealer is adjusted or featured. Every won product is listed with its page URL, total and collection time. Optional parameter metal=gold|silver. The answer is 503 rather than partial counts. The rules are at https://guldpriser.se/topplista.

Circulated and mixed offers: a dealer's listing such as "Guldtacka 100 gram - Varierande tillverkare och skick" is priced for whatever mint and condition the dealer has, so it is classed as circulated and hidden from the default comparison, as on the site, and it never counts for "Bästa pris". Pass include_circulated=true to /api/v2/offers to get them too; every offer carries circulated (true or false), and the hidden block of every answer counts what was left out (circulated, sold_out) and the cheapest known total among the hidden circulated offers.

News: /api/v2/news lists articles (summaries, each with api_url); /api/v2/news/{id} returns one published article in full as Markdown in body_markdown(tables and product cards as readable text), with title, category, times, page_url, the hero image and the sources. The articles are guldpriser.se's own editorial content, in Swedish: cite them with page_url.

An MCP server (Model Context Protocol, Streamable HTTP, stateless, no authentication) is at https://guldpriser.se/mcp. Its tools wrap the API handlers and return the same JSON: search_offers, get_sell_quotes, get_spot, get_spot_history, get_catalog, get_dealer_ranking, list_dealers, get_dealer, list_news and get_news_article. The rate limit is shared with the API; the null rules above apply to every tool. Guldpriser.se sells nothing: offer_url is the dealer's own page and page_url is the matching page on this site.

{ "mcpServers": { "guldpriser": { "type": "http", "url": "https://guldpriser.se/mcp" } } }