API voor prijsdata — monitoringgegevens in uw eigen systemen
Met de REST API van 4pricing.net kan uw team de gegevens uit de prijsmonitoring uitlezen en aan de eigen systemen koppelen (ERP, WMS, e-commerceplatform). Er zijn geen kant-en-klare connectoren: de koppeling bouwt u op de API. De authenticatie verloopt met een API-sleutel, de antwoorden zijn standaard JSON en de specificatie is gepubliceerd als OpenAPI 3.0, die u direct in uw client kunt importeren.
Belangrijkste endpoints
De API levert de monitoringgegevens op het niveau van het gevolgde product: de productlijst met de actuele prijs, de prijshistorie van één product en een bulk-minihistorie voor lijstweergaven. Producten worden geïdentificeerd met de product_id die u bij het toevoegen terugkrijgt — de product-URL dient om het product toe te voegen, niet als sleutel in de route. Bedragen komen in minuseenheden binnen, in de velden current_price_cents en price_cents, samen met de valuta, en elke registratie draagt het exacte tijdstip van de controle (respectievelijk last_scraped_at en scraped_at).
- GET /products/ — uw gevolgde producten, met actuele prijs en valuta
- GET /products/{product_id}/history — de prijshistorie van één product, met tijdstempels
- GET /products/sparklines — bulk-minihistorie, één reeks prijzen per product
- POST /alerts/ — een melding aanmaken (drempel, procentuele daling, voorraad, concurrent)
Authenticatie en rate limiting
De authenticatie verloopt via de header X-API-Key of, gelijkwaardig, via Authorization: Bearer met dezelfde sleutel. Sleutels genereert u in het paneel, in de sectie API en sleutels; de volledige waarde ziet u maar één keer, bij het aanmaken. De rate limit is 60 requests per minuut per account, gedeeld door al uw sleutels; daarboven antwoordt de API met 429 en stuurt ze de header Retry-After mee.
Voordelen en beperkingen
Voordelen
- Via de API te koppelen aan uw ERP/WMS, zonder handmatige CSV-export — de ontwikkeling doet uw eigen team, er zijn geen kant-en-klare connectoren
- Meldingen komen per webhook binnen, dus u hoeft niet te pollen
- Een gepubliceerde OpenAPI 3.0-specificatie die u direct in uw client importeert
- Toegang tot de aanbevolen prijs voor de vergelijkingsgroep, niet alleen tot ruwe data
Beperkingen
- De limiet van 60 requests/minuut per account (gedeeld door alle sleutels) vraagt bij grote assortimenten om bulkuitlezingen en lokale caching
- De webhook vereist een publieke http/https-URL (poort 80/443) in uw eigen infrastructuur
Kort oordeel
De API dekt de gangbare scenario's om een eigen koppeling met uw systemen te bouwen. Assortimenten met meer dan 50.000 actieve SKU's varen wel bij bulk-uitlezing en lokale caching.
Specificatietabel
| Endpoint | Methode | Antwoord |
|---|---|---|
| /products/ | GET | JSON-array met gevolgde producten, met current_price_cents |
| /products/{product_id}/history | GET | JSON-array met historie en tijdstempels |
| /products/sparklines | GET | JSON met één reeks prijzen per product |
| /alerts/ | POST | De aangemaakte melding, met type en drempel |
API versus CSV-export op aanvraag
| Criterium | REST API | CSV-export |
|---|---|---|
| Datalatentie | De data zijn zo oud als de laatste controle | Data van het moment van downloaden |
| Koppeling met uw ERP | Door uw eigen team gebouwd via HTTP (geen kant-en-klare connector) | Handmatige import of via cron |
| Pushmeldingen | Ja (webhook) | Nee |
Veelgestelde vragen
Hoe krijg ik een API-sleutel?
U genereert de sleutel in het paneel van uw 4pricing.net-account, in de sectie API en sleutels. De volledige waarde ziet u maar één keer, bij het aanmaken — bent u die kwijt, trek de sleutel dan in en genereer een nieuwe.
Kan ik de gegevens van alle producten tegelijk opvragen?
Ja, met GET /products/?skip=0&limit=200 loopt u het hele gevolgde assortiment pagina voor pagina door; het totale aantal rijen staat in de header X-Total-Count. Voor lange lijsten geeft GET /products/sparklines de minihistorie van meerdere producten in één aanroep. Bij grote assortimenten adviseren we een nachtelijke uitlezing die u zelf inplant en vaker uitlezen alleen voor de producten die ertoe doen.
Welk formaat heeft de prijshistorie die de API teruggeeft?
Een JSON-array met objecten {product_id, price_cents, currency, in_stock, scraped_at}, aflopend gesorteerd op datum. De prijs komt in minuseenheden (price_cents), niet in hele valuta, en scraped_at is een exacte ISO 8601-tijdstempel.
Welke gebeurtenissen stuurt de webhook?
Er is één webhook-URL per account, en die ontvangt elk meldingstype dat u aanmaakt: prijs onder een drempel, prijs boven een drempel, procentuele daling, weer op voorraad, een concurrent die onder u gaat zitten en verlies van de laagsteprijspositie. Een melding op de kostprijsbodem als zodanig bestaat niet.