Elgiganten Search Scraper

Collect rich product search data from Elgiganten and export it as structured dataset items for monitoring, analysis, and catalog intelligence.

---

Description

This actor captures search results from URLs like https://www.elgiganten.se/search?q=mobile&view=products and returns detailed item data. Output includes pricing, stock, taxonomy, campaign flags, rating data, and many additional populated fields.

---

Features

• Extracts rich search result records with broad product coverage.
• Supports keyword mode and custom search URL mode.
• Uses server pagination to collect large result sets reliably.
• Removes empty/null fields from output records.
• Can optionally include cleaned raw record objects for full field coverage.

---

Use Cases

• Track price, stock, and seller movements over time.
• Build product intelligence datasets for market analysis.
• Monitor rank/position changes for target keywords.
• Feed BI dashboards and alerting workflows.

---

Input Parameters

Parameter	Type	Description
startUrl	string	Optional Elgiganten search URL with query parameters.
keyword	string	Search keyword when startUrl is not provided.
results_wanted	integer	Maximum number of records to collect. Default: 20.
max_pages	integer	Maximum pages to request. Default: 10.
proxyConfiguration	object	Optional proxy settings (datacenter, residential, or none).

---

Output Data

Field	Type	Description
searchQuery	string	Search keyword/query used for extraction.
searchTotalResults	integer	Total matching product hits.
page	integer	Search page number.
position	integer	Item position in the page.
resultType	string	product or content.
productId	string	Product ID / SKU.
title	string	Product/content title.
url	string	Absolute item URL.
brand	string	Brand name.
sellerName	string	Seller/merchant name.
priceCurrent	number	Current displayed price.
priceCurrentExVat	number	Current displayed ex-VAT price.
priceCurrency	string	Currency code.
onlineStockInStock	boolean	Online stock availability flag.
onlineStockLevel	string	Stock level text (example: 25+).
storesWithStockCount	integer	Number of stores with stock.
ratingScore	number	Average rating score.
ratingCount	integer	Number of ratings/reviews.
taxonomy	array	Product taxonomy path.
bulletPoints	array	Product bullet points.
campaigns	array/object	Campaign metadata when present.
imageUrl	string	Product image URL.
apiRecord	object	Cleaned non-null full source record (optional).

---

Usage Examples

{
  "startUrl": "https://www.elgiganten.se/search?q=mobile&view=products",
  "results_wanted": 20,
  "max_pages": 3
}

{
  "keyword": "iphone",
  "results_wanted": 100,
  "max_pages": 5
}

---

Sample Output

{
  "source": "elgiganten-api-search",
  "resultType": "product",
  "searchQuery": "mobile",
  "page": 1,
  "position": 1,
  "searchTotalResults": 120963,
  "productId": "1000290",
  "title": "DJI Osmo Mobile 8 gimbalstabilisator",
  "url": "https://www.elgiganten.se/product/sport-fritid/foto-bild-kamera/tillbehor-till-kamera/kamerahandtag/dji-osmo-mobile-8-gimbalstabilisator/1000290",
  "brand": "DJI",
  "sellerName": "Elgiganten",
  "priceCurrency": "SEK",
  "priceCurrent": 1949,
  "priceCurrentExVat": 1559.2,
  "onlineStockInStock": true,
  "onlineStockLevel": "25+",
  "storesWithStockCount": 22,
  "taxonomy": [
    "Sport & Fritid",
    "Foto, Bild & Kamera",
    "Tillbehör till Kamera",
    "Kamerahandtag"
  ],
  "bulletPoints": [
    "ActiveTrack 7.0-stabilisering",
    "Inbyggd förlängningsstång & stativ",
    "10 timmars batteritid"
  ],
  "imageUrl": "https://next-media.elkjop.com/image/dv_web_D18000136010389/1000290/dji-osmo-mobile-8-gimbalstabilisator.jpg"
}

---

Tips

• Use modest results_wanted for quick scheduled checks.
• Run on schedule to track price and stock deltas.

---

Integrations

• Export datasets to CSV/JSON for BI platforms.
• Trigger workflows via webhooks for monitoring alerts.
• Join outputs with internal product catalogs by SKU.

---

FAQ

Why are some keys missing in some items?

Fields are included only when they contain values. Empty/null fields are removed to keep output clean.

Can I start from a custom filtered search URL?

Yes. Put the URL in startUrl and the scraper reuses its query parameters.

---

Legal Notice

You are responsible for compliance with applicable laws, platform terms, and acceptable data usage policies when running this actor.