API dati prezzi — accedi ai dati di monitoraggio dai tuoi sistemi
L'API REST di 4pricing.net permette al tuo team di leggere i dati di monitoraggio prezzi e di collegarli ai propri sistemi (ERP, WMS, piattaforma e-commerce). Non esistono connettori già pronti: il collegamento si sviluppa sull'API. L'autenticazione avviene tramite chiave API, le risposte sono in JSON standard e la specifica è pubblicata in formato OpenAPI 3.0, importabile direttamente nel tuo client.
Endpoint principali
L'API espone i dati di monitoraggio a livello di prodotto monitorato: l'elenco dei prodotti con il prezzo attuale, lo storico dei prezzi di un singolo prodotto e un mini-storico in blocco per le viste a elenco. I prodotti sono identificati dal product_id restituito al momento dell'aggiunta — l'URL della scheda serve per aggiungere il prodotto, non come chiave di rotta. Gli importi arrivano in unità minime, nei campi current_price_cents e price_cents, insieme alla valuta, e ogni record riporta l'orario esatto del controllo (rispettivamente last_scraped_at e scraped_at).
- GET /products/ — i tuoi prodotti monitorati, con prezzo attuale e valuta
- GET /products/{product_id}/history — lo storico dei prezzi di un prodotto, con marche temporali
- GET /products/sparklines — mini-storico in blocco, una serie di prezzi per prodotto
- POST /alerts/ — crea un avviso (soglia, calo percentuale, disponibilità, concorrente)
Autenticazione e limite di frequenza
L'autenticazione usa l'header X-API-Key oppure, in modo equivalente, Authorization: Bearer con la stessa chiave. Le chiavi si generano dal pannello, nella sezione API e chiavi, e il valore completo viene mostrato una sola volta, alla creazione. Il limite è di 60 richieste al minuto per account, condiviso da tutte le tue chiavi; oltre tale soglia l'API risponde 429 e invia l'header Retry-After.
Vantaggi e limiti
Vantaggi
- Collegabile al tuo ERP/WMS tramite API, senza export CSV manuale — lo sviluppo è a cura del tuo team, non esistono connettori pronti
- Gli avvisi possono arrivare via webhook, quindi non sei costretto al polling
- Specifica OpenAPI 3.0 pubblicata, importabile direttamente nel tuo client
- Accesso al prezzo consigliato per il gruppo di confronto, non solo ai dati grezzi
Limiti
- Il limite di 60 richieste/minuto per account (condiviso da tutte le chiavi) impone letture in blocco e cache locale sui cataloghi ampi
- Il webhook richiede un URL http/https pubblico (porta 80/443) sulla tua infrastruttura
Verdetto rapido
L'API copre gli scenari standard per costruire un collegamento con i tuoi sistemi. I cataloghi con oltre 50.000 SKU attivi traggono vantaggio dalle letture in blocco e dalla cache locale.
Tabella delle specifiche
| Endpoint | Metodo | Risposta |
|---|---|---|
| /products/ | GET | Array JSON dei prodotti monitorati, con current_price_cents |
| /products/{product_id}/history | GET | Array JSON dello storico con marche temporali |
| /products/sparklines | GET | JSON con una serie di prezzi per prodotto |
| /alerts/ | POST | L'avviso creato, con tipo e soglia |
API vs. export CSV su richiesta
| Criterio | API REST | Export CSV |
|---|---|---|
| Latenza dei dati | I dati risalgono all'ultimo controllo | Dati aggiornati al momento del download |
| Collegamento al tuo ERP | Lo sviluppa il tuo team via HTTP (nessun connettore pronto) | Importazione manuale o via cron |
| Avvisi push | Sì (webhook) | No |
Domande frequenti
Come ottengo una chiave API?
La chiave si genera dal pannello del tuo account 4pricing.net, nella sezione API e chiavi. Il valore completo viene mostrato una sola volta, alla creazione — se lo perdi, revoca la chiave e generane un'altra.
Posso accedere ai dati di tutti i prodotti contemporaneamente?
Sì, GET /products/?skip=0&limit=200 ti permette di sfogliare a pagine l'intero catalogo monitorato; il numero totale di righe arriva nell'header X-Total-Count. Per gli elenchi lunghi, GET /products/sparklines restituisce il mini-storico di più prodotti in una sola chiamata. Per i cataloghi ampi consigliamo una lettura notturna pianificata da te e letture più frequenti solo per i prodotti che contano.
Che formato ha lo storico dei prezzi restituito dall'API?
Un array JSON di oggetti {product_id, price_cents, currency, in_stock, scraped_at}, ordinati per data decrescente. Il prezzo arriva in unità minime (price_cents), non in valuta intera, e scraped_at è una marca temporale ISO 8601 esatta.
Quali eventi invia il webhook?
C'è un solo URL webhook per account e riceve ogni tipo di avviso che crei: prezzo sotto una soglia, prezzo sopra una soglia, calo percentuale, ritorno in disponibilità, un concorrente che scende sotto il tuo prezzo e perdita della posizione di prezzo più basso. Non esiste un avviso sulla soglia di costo in quanto tale.