eMAG API: produse, prețuri și oferte ale comercianților în JSON
eMAG Marketplace are propria interfață pentru comercianți, iar aceea îți arată catalogul tău. Această API răspunde la cealaltă întrebare: ce se vinde pe piață, la ce preț și de către cine. Nu ai nevoie de cont de comerciant, iar răspunsul vine direct în JSON.
Endpointuri
| endpoint | Ce returnează | Obligatorii |
|---|---|---|
| search | Căutare după cuvânt cheie, paginată și sortabilă, cu filtre de interval de preț, brand și disponibilitate în stoc. | query |
| category | Răsfoirea unei categorii după slug, cu aceleași filtre ca la căutare. | category |
| product/detail | Fișa completă după `code` sau `url`: titlu, brand, codul producătorului, prețul curent și imaginile. | toate opționale |
| product/offers | Esențialul: toți comercianții care vând același produs pe eMAG — oferta din buybox plus restul, fiecare cu prețul ei. | toate opționale |
Fiecare apel se taxează în credite. Apelurile eșuate și blocate sunt gratuite.
Exemplu funcțional
Prețul din listă este oferta din buybox, nu cel mai mic preț de pe pagină. Cine compară corect cere product/offers, pentru că abia acolo se vede cine concurează cu cine.
curl -X POST https://api.reefapi.com/emag/v1/product/offers \
-H "x-api-key: CHEIA_TA" \
-H "content-type: application/json" \
-d '{"code": "..."}'{
"ok": true,
"data": {
"offers": [
{
"seller": "...",
"price": 2499.0,
"currency": "RON",
"is_buybox": true
}
]
},
"meta": { "record_count": 6, "cache_hit": false, "mode": "live" }
}În loc să îți scrii propriul scraper de eMAG
Un scraper propriu pentru eMAG funcționează în prima zi. Problema apare mai târziu: când se schimbă structura paginii, parserul întoarce o listă goală în loc de eroare, iar la o rulare mai lungă protecția anti-bot taie execuția la mijloc. Ambele arată la tine ca „nu există produse”.
Aici întreținerea este la noi: dacă se schimbă schema, reparăm motorul; dacă apare o blocare, se întoarce un cod de eroare și acel apel nu se taxează.
Pentru o extragere unică, scriptul tău rămâne mai ieftin și o spunem direct. Pentru o monitorizare care trebuie să ruleze zilnic, costul nu stă în cod, ci în defecțiunile pe care nu le observă nimeni.
Limite și note oneste
- Nu este API-ul oficial eMAG și nu avem niciun parteneriat cu eMAG.
- Prețul din listă este oferta din buybox; restul ofertelor apar doar în product/offers.
- Dacă un comerciant nu publică stocul, câmpul vine null — nu inventăm valori.
- Fără cache: fiecare apel arată starea din acel moment.