API för prisdata — nå bevakningsdatan från dina egna system
REST-API:et i 4pricing.net låter ditt team läsa prisbevakningsdatan och koppla den till egna system (affärssystem, lagersystem, e-handelsplattform). Det finns inga färdiga kopplingar — kopplingen byggs ovanpå API:et. Autentiseringen sker med API-nyckel, svaren är vanlig JSON och specifikationen publiceras som OpenAPI 3.0, som du kan importera rakt in i din klient.
Viktigaste endpoints
API:et exponerar bevakningsdata på nivån bevakad produkt: produktlistan med aktuellt pris, prishistoriken för en produkt och en minihistorik i bulk för listvyer. Produkter identifieras med det product_id som returneras när du lägger till dem — produktens URL används för att lägga till produkten, inte som nyckel i sökvägen. Belopp anges i minsta valutaenhet, i fälten current_price_cents och price_cents, tillsammans med valutan, och varje post bär den exakta tidpunkten för kontrollen (last_scraped_at respektive scraped_at).
- GET /products/ — dina bevakade produkter, med aktuellt pris och valuta
- GET /products/{product_id}/history — prishistoriken för en produkt, med tidsstämplar
- GET /products/sparklines — minihistorik i bulk, en prisrad per produkt
- POST /alerts/ — skapa en avisering (tröskelvärde, procentuellt prisfall, lager, konkurrent)
Autentisering och anropsgränser
Autentiseringen sker med headern X-API-Key eller, likvärdigt, Authorization: Bearer med samma nyckel. Nycklar genereras i panelen, under API och nycklar, och hela värdet visas bara en gång, när nyckeln skapas. Gränsen är 60 anrop per minut och konto, gemensam för alla dina nycklar; däröver svarar API:et med 429 och skickar headern Retry-After.
Fördelar och begränsningar
Fördelar
- Kan kopplas till ditt affärs- eller lagersystem via API, utan manuell CSV-export — utvecklingen görs av ditt eget team, det finns inga färdiga kopplingar
- Aviseringar kan levereras via webhook, så du slipper polla
- Publicerad OpenAPI 3.0-specifikation som du importerar rakt in i din klient
- Tillgång till det rekommenderade priset för jämförelsegruppen, inte bara rådata
Begränsningar
- Gränsen på 60 anrop/minut per konto (gemensam för alla nycklar) kräver bulkläsning och lokal cachning vid stora sortiment
- Webhooken kräver en offentlig http/https-URL (port 80/443) i din egen infrastruktur
Kort omdöme
API:et täcker de vanliga scenarierna för att bygga en egen koppling mot dina system. Sortiment med över 50 000 aktiva artiklar tjänar på bulkläsning och lokal cachning.
Specifikationstabell
| Endpoint | Metod | Svar |
|---|---|---|
| /products/ | GET | JSON-array med bevakade produkter, med current_price_cents |
| /products/{product_id}/history | GET | JSON-array med historik och tidsstämplar |
| /products/sparklines | GET | JSON med en prisrad per produkt |
| /alerts/ | POST | Den skapade aviseringen, med typ och tröskelvärde |
API kontra CSV-export på begäran
| Kriterium | REST-API | CSV-export |
|---|---|---|
| Datafördröjning | Datan är lika gammal som senaste kontrollen | Data från det ögonblick du laddar ner |
| Koppling till ditt affärssystem | Byggs av ditt eget team via HTTP (ingen färdig koppling) | Manuell import eller via cron |
| Push-aviseringar | Ja (webhook) | Nej |
Vanliga frågor
Hur får jag en API-nyckel?
Du genererar nyckeln i panelen för ditt 4pricing.net-konto, under API och nycklar. Hela nyckelvärdet visas bara en gång, när den skapas — tappar du bort det, återkalla nyckeln och generera en ny.
Kan jag hämta data för alla produkter samtidigt?
Ja, med GET /products/?skip=0&limit=200 bläddrar du igenom hela det bevakade sortimentet; totalt antal rader kommer i headern X-Total-Count. För långa listor returnerar GET /products/sparklines minihistoriken för flera produkter i ett enda anrop. Vi rekommenderar en nattlig läsning som du själv schemalägger för stora sortiment, och tätare läsningar bara för de produkter som betyder mest.
Vilket format har prishistoriken som API:et returnerar?
En JSON-array med objekt av typen {product_id, price_cents, currency, in_stock, scraped_at}, sorterade fallande efter datum. Priset anges i minsta valutaenhet (price_cents), inte i hela kronor, och scraped_at är en exakt tidsstämpel enligt ISO 8601.
Vilka händelser skickar webhooken?
Det finns en webhook-URL per konto, och den tar emot varje aviseringstyp du skapar: pris under ett tröskelvärde, pris över ett tröskelvärde, procentuellt prisfall, åter i lager, en konkurrent som underprissätter dig och förlorad position som billigast. Det finns ingen avisering för prisgolvet i sig.