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)