Prețuri din magazine

De unde vin aceste date, pe față

Magazinele

GET/v1/prices/stores

Magazinele din API, cu numărul de produse și data ultimei citiri.

Credite: 1
: Cu cheie

Parametri

Fără parametri.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/prices/stores" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/prices/stores", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/prices/stores",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/prices/stores");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": [
    {
      "key": "george",
      "name": "George Standard",
      "domain": "ggg.md",
      "kind": "grocery",
      "products": 96,
      "updated_at": "2026-11-03"
    },
    {
      "key": "kaufland",
      "name": "Kaufland",
      "domain": "kaufland.md",
      "kind": "grocery",
      "products": 27,
      "updated_at": "2026-11-03"
    }
  ],
  "meta": {
    "credits": 1,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "George Standard",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      },
      {
        "name": "Kaufland",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

Caută un produs

GET/v1/prices/search

Caută produse după nume. Costă 3 credite pe 20 de rânduri. Se oprește la pagina 5.

Credite: 3 pentru fiecare 20 rânduri
: Cu cheie

Parametri

qstringobligatoriu

Între 2 și 100 de caractere.
categorystringopțional

Cheia categoriei, din /v1/news/categories.
storestringopțional

Cheia magazinului, din /v1/prices/stores.
in_stockbooleanopțional

1 ca să primești doar ce e în stoc.
pageintegeropționalimplicit 1

Pagina, de la 1 la 5.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/prices/search?q=Gri%C8%99%2C%20arpaca%C8%99%20%C8%99i%20alte%20crupe" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/prices/search?q=Gri%C8%99%2C%20arpaca%C8%99%20%C8%99i%20alte%20crupe", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/prices/search?q=Gri%C8%99%2C%20arpaca%C8%99%20%C8%99i%20alte%20crupe",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/prices/search?q=Gri%C8%99%2C%20arpaca%C8%99%20%C8%99i%20alte%20crupe");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": [
    {
      "id": 18342,
      "slug": "bunica-arpacas-de-grau-900g",
      "name": "bunica Arpacaș de grâu 900 g",
      "brand": "Arpacaș",
      "capacity": "900 g",
      "category": "groceries",
      "min_price": 5.95,
      "median_price": 5.95,
      "unit_min_price": 6.61,
      "price_unit": "kg",
      "stores": 1,
      "in_stock_stores": 1,
      "updated_at": "2026-11-03T00:31:34+02:00"
    }
  ],
  "meta": {
    "credits": 3,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Kaufland",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)",
    "page": {
      "page": 1,
      "per": 20,
      "total": 1,
      "pages": 1
    }
  }
}

Grupele de produse

GET/v1/prices/groups

Produsele generale din catalog, ca laptele sau pâinea, cu cel mai mic preț și mediana.

Credite: 2
: Cu cheie

Parametri

categorystringopțional

Cheia categoriei, din /v1/news/categories.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/prices/groups" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/prices/groups", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/prices/groups",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/prices/groups");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": [
    {
      "id": "crupe",
      "name": "Griș, arpacaș și alte crupe",
      "unit": "kg",
      "min_price": 5.95,
      "median_price": 12.24,
      "unit_min_price": 6.61,
      "price_unit": "kg",
      "stores": 6
    }
  ],
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Kaufland",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      },
      {
        "name": "Carmez",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      },
      {
        "name": "MegaAlina",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      },
      {
        "name": "PandaShop",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

O grupă, cu oferte

GET/v1/prices/groups/{id}

Grupa și cel mult 50 de oferte, cea mai ieftină prima.

Credite: 3
: Cu cheie

Parametri

idstringobligatoriu

Identificatorul rândului.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/prices/groups/crupe" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/prices/groups/crupe", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/prices/groups/crupe",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/prices/groups/crupe");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": {
    "id": "crupe",
    "name": "Griș, arpacaș și alte crupe",
    "unit": "kg",
    "min_price": 5.95,
    "median_price": 12.24,
    "unit_min_price": 6.61,
    "price_unit": "kg",
    "stores": 6,
    "offers": [
      {
        "store": {
          "key": "kaufland",
          "name": "Kaufland"
        },
        "title": "De la bunica Arpacaș de grâu 900 g",
        "price": 5.95,
        "old_price": 6.75,
        "discount_pct": 12,
        "unit_price": 6.61,
        "unit": "kg",
        "in_stock": true,
        "url": "https://www.kaufland.md/ro/cautare.html?q=20680825",
        "last_seen": "2026-11-03T00:31:34+02:00"
      },
      {
        "store": {
          "key": "george",
          "name": "George Standard"
        },
        "title": "QUINOA biologica GAROFALO 5303, 300g",
        "price": 59,
        "old_price": null,
        "discount_pct": null,
        "unit_price": 196.67,
        "unit": "kg",
        "in_stock": true,
        "url": "https://ggg.md/ro/shop/quinoa-biologica-garofalo-5303-300g",
        "last_seen": "2026-11-03T00:35:05+02:00"
      }
    ]
  },
  "meta": {
    "credits": 3,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Kaufland",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      },
      {
        "name": "George Standard",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

Un produs, cu oferte

GET/v1/prices/items/{id}

Un produs anume și ofertele lui din fiecare magazin.

Credite: 2
: Cu cheie

Parametri

idintegerobligatoriu

Identificatorul rândului.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/prices/items/18342" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/prices/items/18342", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/prices/items/18342",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/prices/items/18342");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": {
    "id": 18342,
    "slug": "bunica-arpacas-de-grau-900g",
    "name": "bunica Arpacaș de grâu 900 g",
    "brand": "Arpacaș",
    "capacity": "900 g",
    "category": "groceries",
    "min_price": 5.95,
    "median_price": 5.95,
    "unit_min_price": 6.61,
    "price_unit": "kg",
    "stores": 1,
    "in_stock_stores": 1,
    "updated_at": "2026-11-03T00:31:34+02:00",
    "offers": [
      {
        "store": {
          "key": "kaufland",
          "name": "Kaufland"
        },
        "title": "De la bunica Arpacaș de grâu 900 g",
        "price": 5.95,
        "old_price": 6.75,
        "discount_pct": 12,
        "unit_price": 6.61,
        "unit": "kg",
        "in_stock": true,
        "url": "https://www.kaufland.md/ro/cautare.html?q=20680825",
        "last_seen": "2026-11-03T00:31:34+02:00"
      }
    ]
  },
  "meta": {
    "credits": 2,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "Kaufland",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}

Istoricul unui produs

GET/v1/prices/items/{id}/history

Prețurile pe zile și pe magazine. Costă 5 credite pentru fiecare 30 de zile începute.

Credite: 5 pentru fiecare 30 zile începute
: Cu cheie

Parametri

idintegerobligatoriu

Identificatorul rândului.
daysintegeropționalimplicit 30

Câte zile în urmă. Tăiat la limita planului.
storestringopțional

Cheia magazinului, din /v1/prices/stores.

Erori posibile

Încearcă

curl "https://api.satelit.md/v1/prices/items/18342/history?days=30" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/prices/items/18342/history?days=30", {
  headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` },
});
const { data, meta } = await res.json();
console.log(data, meta.credits);

import json, os, urllib.request

req = urllib.request.Request(
    "https://api.satelit.md/v1/prices/items/18342/history?days=30",
    headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"},
)
with urllib.request.urlopen(req) as res:
    body = json.load(res)
print(body["data"], body["meta"]["credits"])

<?php
$ch = curl_init("https://api.satelit.md/v1/prices/items/18342/history?days=30");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body["data"]);

Răspuns

{
  "data": {
    "points": [
      {
        "date": "2026-11-02",
        "store": "kaufland",
        "price": 5.95,
        "old_price": null,
        "unit_price": 6.61,
        "in_stock": true
      },
      {
        "date": "2026-11-03",
        "store": "kaufland",
        "price": 5.95,
        "old_price": null,
        "unit_price": 6.61,
        "in_stock": true
      }
    ]
  },
  "meta": {
    "credits": 5,
    "updated_at": "2026-11-02T13:05:00+02:00",
    "sources": [
      {
        "name": "kaufland",
        "license": "none: read from the shop's public pages; no agreement with the shop and no licence over its data is granted"
      }
    ],
    "attribution": "Date: Satelit (satelit.md)"
  }
}