Compari.ro API: ofertele magazinelor din România, în lei, ca JSON

Compari.ro este varianta românească a platformei Árukereső, iar motorul care o citește se numește `arukereso`: același cod servește arukereso.hu, compari.ro și pazaruvaj.com, așa că pentru România trimiți `"country": "ro"` la fiecare apel. Pentru un produs primești datele de pe pagina lui de comparare: prețul minim actual în lei, fiecare ofertă de magazin cu costul livrării și prețul total acolo unde magazinul le declară, nota magazinului, termenul de livrare și dacă poziția e plătită ca sponsorizare. În plus, `price_history` dă graficul prețului minim și al celui mediu, așa cum îl desenează site-ul. Nu e interfața prin care magazinele își trimit feed-ul de produse în Compari și nici panoul lor de administrare: API-ul nu încarcă și nu modifică nimic, doar citește paginile publice ale comparatorului.

Exemplu funcțional

Pentru Samsung Galaxy S25 128GB, `offers` a întors 36 de oferte în ordinea de pe compari.ro. Primele trei poziții sunt sponsorizate și niciuna nu e cea mai ieftină: oferta minimă, 2 713,86 RON cu livrare gratuită, era pe poziția 5. Atenție la `listing_type: "free"`: înseamnă o listare neplătită a magazinului, nu livrare gratuită (aceea e `free_shipping`). La 23 din cele 36 de oferte magazinul nu declara costul livrării, deci `shipping_cost` și `total_price` sunt null; o comparație corectă pe preț total se poate face doar între ofertele care îl au.

curl -X POST https://api.reefapi.com/arukereso/v1/offers \
  -H "x-api-key: CHEIA_TA" \
  -H "content-type: application/json" \
  -d '{"product_id": "1170024967", "country": "ro"}'

{
  "ok": true,
  "data": {
    "product_id": "1170024967",
    "title": "Samsung Galaxy S25 5G 128GB 12GB RAM Dual (SM-S931)",
    "url": "https://www.compari.ro/telefoane-mobile-c3277/samsung/galaxy-s25-5g-128gb-12gb-ram-dual-sm-s931-p1170024967/",
    "country": "ro",
    "currency": "RON",
    "lowest_price": 2713.86,
    "cheapest_total_price": 2713.86,
    "offer_count": 36,
    "source_offer_counts": { "paid": 25, "sponsored": 3, "free": 12 },
    "duplicates_removed": 2,
    "offers": [
      ...
      {
        "position": 2,
        "shop_name": "notebookgsm.ro",
        "shop_rating_stars": 5.0,
        "shop_review_count": 540,
        "shop_trusted": true,
        "offer_title": "Samsung Galaxy S25 5G - Icyblue 12 GB 128 GB (SM-S931BLBDEUE)",
        "price": 2828,
        "price_text": "2 828,00 RON",
        "shipping_cost": 29.0,
        "free_shipping": false,
        "shipping_text": "+ 29,00 RON costul livrarii",
        "total_price": 2857.0,
        "in_stock": null,
        "delivery_time": "Detalii de livrare la magazin",
        "condition": "new",
        "listing_type": "sponsored"
      },
      ...
      {
        "position": 5,
        "shop_name": "mobiro.eu",
        "shop_rating_stars": 1.0,
        "shop_review_count": 1,
        "shop_trusted": false,
        "offer_title": "Samsung Galaxy S25 12GB 128GB 5G Black Smartphone (SM-S931BZKDEUE)",
        "price": 2713.86,
        "price_text": "2 713,86 RON",
        "shipping_cost": 0,
        "free_shipping": true,
        "shipping_text": "Livrare gratuita",
        "total_price": 2713.86,
        "delivery_time": "Livrare: max 2 sapt.",
        "condition": "new",
        "listing_type": "paid"
      },
      ...
    ]
  },
  "meta": { "record_count": 36, "country": "ro", "charged_credits": 3, "cache_hit": false, "mode": "live" }
}

Limite și note oneste

• Compari și Árukereső n-au construit și nu susțin acest API; nu e o interfață oficială a comparatorului, iar noi nu suntem parteneri ai lor.
• Fără `"country": "ro"` cererea ajunge pe arukereso.hu, cu prețuri în forinți. Id-urile de produs și de categorie sunt comune celor trei site-uri.
• Numărul de oferte din căutare nu e același cu lista din `offers`: rândul Galaxy S25 128GB arăta 160 de oferte, `offers` a întors 36. Pentru număr și prețuri pe magazine, folosește `offers`.
• Costul livrării apare doar când magazinul îl declară (13 din 36 de oferte în exemplu). Stocul nu e un număr: `in_stock` era null la 28 din 36, iar termenul vine ca text în `delivery_time`.
• La unele produse nu există tabel de specificații: la telefonul din exemplu `specs` a venit null și descrierea tehnică e doar text liber, în `spec_text`.
• Căutarea nu întoarce totalul de rezultate, doar `last_page`, și se oprește la pagina 100. La „anvelope iarna 205/55 r16” toate cele 20 de rânduri erau oferte ale unui singur magazin (`shop_offer`), fără comparație între magazine pe rând.
• Istoricul de preț e cel din graficul site-ului: pentru telefonul din exemplu, 30 de puncte între 28 ianuarie 2025 și 26 octombrie 2026, nu fiecare zi.
• `search`, `category`, `product` și `offers` costă câte 3 credite pe apel; `price_history` 1 credit.