Allegro Product Content by EAN — Photos, Description & Parameters

🇵🇱 Polski poniżej · 🇬🇧 English below

---

🇵🇱 Po polsku

Masowy scraper treści produktowych z Allegro.pl. Wklejasz kody EAN/GTIN, a dla każdego aktor znajduje produkt na allegro.pl i zwraca:

• Zdjęcia — galeria produktu w pełnej rozdzielczości (a.allegroimg.com/original/…). Ustaw, ile zdjęć chcesz (maxImages).
• Opis — pełny HTML (nagłówki, pogrubienia, tabele, obrazki) albo czysty tekst (descriptionFormat). Można wyłączyć (fetchDescription).
• Parametry — karta specyfikacji jako mapa klucz → wartość (np. {"Marka":"Blaupunkt","Przekątna ekranu":"43\""}). Domyślnie włączone (fetchParameters).

Do 1000 EAN-ów na run.

Opcje

• Wybór produktu (productSelection) — gdy jeden EAN pasuje do kilku kart: relevance (najlepsza trafność, domyślnie) lub popularity (najpopularniejszy; gdy Allegro nie udostępnia sygnału — powrót do trafności).
• Ile zdjęć (maxImages) — domyślnie 3. Pierwsze 3 są w cenie bazowej, każde kolejne jest dodatkowo płatne (na planach płatnych Apify — gratis). Ustaw 1, by pobrać tylko zdjęcie główne.
• Pobieranie plików zdjęć (downloadImages, opcjonalne) — pobiera pliki do magazynu Key-Value Store tego runu i dodaje link file obok originalUrl.
  • ⚠️ Pliki w KV są dostępne ~7 dni (okno retencji datasetu) — pobierz je u siebie w tym czasie.
  • originalUrl (CDN Allegro) zwracamy ZAWSZE i nie wygasa — powiązanie zdjęcie↔produkt zostaje na zawsze, a pliki możesz odtworzyć w każdej chwili.

Jak to działa

1. Dopasowanie EAN → strona produktu przez wyszukiwarkę Allegro (Bright Data Web Unlocker, który przechodzi DataDome na /listing). Cache 24h pomija ten krok przy powtórkach.
2. Pobranie strony /produkt/<uuid> przez Bright Data Scraping Browser (świeże IP per EAN).
3. Ekstrakcja nazwy, marki, kategorii, galerii, opisu i parametrów z osadzonego stanu strony.

Infrastruktura scrapująca jest wliczona — zostaw brightDataWssUrl puste, chyba że masz własne konto Bright Data.

Cennik (pay-per-event, taniej na planach płatnych)

Zdarzenie	Kiedy	Cena (plan Free)
Start aktora	raz na run	$0,50
Treść produktu	per dopasowany EAN — opis + parametry + 3 pierwsze zdjęcia	$0,045
Dodatkowe zdjęcie (URL)	każde zdjęcie powyżej 3	$0,004
Pobrany plik zdjęcia	każdy pobrany plik powyżej 3 (gdy downloadImages)	$0,01
EAN bez dopasowania	gdy kod nie pasuje do żadnego produktu	$0,02

Plany płatne Apify (Starter / Scale / Business) mają niższe stawki, a dodatkowe zdjęcia (URL) są na nich gratis.

---

🇬🇧 In English

Bulk Allegro.pl product-content scraper. Feed it EAN/GTIN codes; for each one it finds the product on allegro.pl and returns:

• Photos — the gallery in full resolution (a.allegroimg.com/original/…). Choose how many photos (maxImages).
• Description — full HTML (headings, bold, tables, embedded images) or clean plain text (descriptionFormat). Toggle off with fetchDescription.
• Parameters — the spec sheet as a flat key → value map (e.g. {"Marka":"Blaupunkt","Przekątna ekranu":"43\""}). On by default (fetchParameters).

Up to 1000 EANs per run.

Options

• Product selection (productSelection) — when one EAN matches several products: relevance (Allegro's top result, default) or popularity (strongest popularity signal; falls back to relevance when Allegro exposes none).
• How many photos (maxImages) — default 3. The first 3 are included in the base price; each photo beyond is billed (free on paid Apify plans). Set 1 for the main image only.
• Download photo files (downloadImages, optional) — downloads the files into this run's Key-Value Store and adds a file link next to each originalUrl.
  • ⚠️ KV files live for ~7 days (dataset retention window) — download them on your side within that time.
  • originalUrl (Allegro CDN) is always returned and never expires — the photo↔product link is permanent and you can re-fetch the files anytime.

How it works

1. Resolve each EAN → product page via Allegro search (Bright Data Web Unlocker, clearing DataDome on /listing). A 24h cache skips this on repeats.
2. Fetch the /produkt/<uuid> page through the Bright Data Scraping Browser (fresh exit IP per EAN).
3. Extract name, brand, category, gallery, description and parameters from Allegro's embedded page state.

Scraping infrastructure is included — leave brightDataWssUrl empty unless you bring your own Bright Data account.

Pricing (pay-per-event, cheaper on paid plans)

Event	When	Price (Free plan)
Actor start	once per run	$0.50
Product content resolved	per matched EAN — description + parameters + first 3 photos	$0.045
Extra image (URL)	each photo beyond 3	$0.004
Image downloaded	each downloaded file beyond 3 (when downloadImages)	$0.01
EAN not found	when a code matches no product	$0.02

Paid Apify plans (Starter / Scale / Business) get lower rates, and extra image URLs are free on them.

Output (one row per EAN)

{
  "ean": "8594213441559",
  "found": true,
  "productId": "…-uuid",
  "productName": "Blaupunkt 43QLW6000S QLED Smart TV 4K UHD WebOS",
  "brand": "Blaupunkt",
  "productUrl": "https://allegro.pl/produkt/…",
  "categoryPath": "Allegro > Elektronika > … > Telewizory",
  "mainImage": "https://a.allegroimg.com/original/…",
  "images": ["https://a.allegroimg.com/original/…", "…"],
  "imageCount": 3,
  "imageFiles": [
    { "originalUrl": "https://a.allegroimg.com/original/…", "file": "https://api.apify.com/v2/key-value-stores/…/img-…-1.jpg" }
  ],
  "description": "<h1>…</h1><p>…</p>",
  "descriptionFormat": "html",
  "parameters": { "Marka": "Blaupunkt", "Model": "43QLW6000S", "…": "…" },
  "parameterCount": 45,
  "scrapedAt": "2026-…"
}

imageFiles is present only with downloadImages: true. EANs with no Allegro match return { "found": false, "error": "…" }.

Notes

• Returns consumer (allegro.pl) product content; prices not included — see Allegro EAN Price Tracker for multi-seller pricing.
• Parameters come from the product page as Allegro presents them; some entries are offer-level (e.g. "Faktura", "Stan opakowania") alongside the technical spec.

---

Built by Klevio · custom scraper? support@klevio.pl