Skip to main content
GET
/
v1
/
products
/
{product_id}
/
snapshots
curl -X GET "https://api.officiscan.com/v1/products/12345/snapshots?days=30" \
  -H "Authorization: Bearer oc_YOUR_API_KEY"

{
  "product_id": 12345,
  "days": 30,
  "data": [
    {
      "id": 98765,
      "collected_at": "2023-06-20T14:30:00",
      "price": {
        "current": 2.99,
        "original": 3.49,
        "range": "2.50-4.00",
        "currency": "EUR"
      },
      "stock": {
        "available": true,
        "label": "En stock"
      },
      "rating": {
        "value": 4.5,
        "count": 127
      },
      "rank": {
        "position": 3,
        "page": 1,
        "page_size": 24
      },
      "promo": {
        "text": "-14%",
        "slug": "promo-ete",
        "type": "percentage",
        "badge": "Promotion",
        "loyalty": {
          "available": true,
          "slug": "affinity-classic"
        }
      }
    }
  ],
  "total": 4,
  "page": 1,
  "per_page": 50,
  "pages": 1
}
​
product_id
integer
required
ID du produit
​
days
integer
default:"30"
Nombre de jours d’historique (max: 90)
​
page
integer
default:"1"
Numéro de page
​
per_page
integer
default:"50"
Résultats par page (max: 100)

​
Description

Retourne l’historique complet des snapshots pour un produit. Chaque snapshot contient les données structurées collectées : prix, stock, rating, position et promotions. 
curl -X GET "https://api.officiscan.com/v1/products/12345/snapshots?days=30" \
  -H "Authorization: Bearer oc_YOUR_API_KEY"

{
  "product_id": 12345,
  "days": 30,
  "data": [
    {
      "id": 98765,
      "collected_at": "2023-06-20T14:30:00",
      "price": {
        "current": 2.99,
        "original": 3.49,
        "range": "2.50-4.00",
        "currency": "EUR"
      },
      "stock": {
        "available": true,
        "label": "En stock"
      },
      "rating": {
        "value": 4.5,
        "count": 127
      },
      "rank": {
        "position": 3,
        "page": 1,
        "page_size": 24
      },
      "promo": {
        "text": "-14%",
        "slug": "promo-ete",
        "type": "percentage",
        "badge": "Promotion",
        "loyalty": {
          "available": true,
          "slug": "affinity-classic"
        }
      }
    }
  ],
  "total": 4,
  "page": 1,
  "per_page": 50,
  "pages": 1
}

​
Structure des objets

​
price

ChampTypeDescription
currentfloatPrix actuel
originalfloatPrix barré (avant promo)
rangestringFourchette de prix
currencystringDevise (EUR)

​
stock

ChampTypeDescription
availablebooleanEn stock
labelstringTexte de disponibilité

​
rating

ChampTypeDescription
valuefloatNote moyenne
countintegerNombre d’avis

​
rank

ChampTypeDescription
positionintegerPosition dans la catégorie
pageintegerNuméro de page
page_sizeintegerProduits par page

​
promo

ChampTypeDescription
textstringTexte de réduction (“-20%”, “-1.00”)
slugstringIdentifiant de l’offre
typestringType de promo (“percentage”, “amount”)
badgestringBadge affiché (“Promotion”, “Offre”)
loyaltyobjectInfo fidélité (si applicable)