# 220.lv Scraper — Latvian Marketplace Products & Prices (`studio-amba/220-lv-scraper`) Actor Scrape products from 220.lv, a large Latvian online marketplace (Pigu Group). Extract prices, original prices, brands, ratings, stock and seller type (1P/3P) for any search or category. No cookies or login required. - **URL**: https://apify.com/studio-amba/220-lv-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 result scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 220.lv Scraper Scrape product data from **220.lv**, a large online marketplace in Latvia running on the Pigu Group platform. Give it a search term or a category URL and it returns a clean, structured list of products: names, prices, discounts, brands, ratings, stock status, seller type and images. No cookies, no login, no browser automation to set up. You pass a search query, you get JSON. ### What this actor does 220.lv lists hundreds of thousands of products across electronics, home, garden, toys, beauty and more, sold both by 220.lv itself (1P) and by third-party marketplace sellers (3P). This actor reads the live search and category pages and extracts every product card into a flat record you can drop straight into a spreadsheet, a database, or a price-monitoring pipeline. Typical uses: - **Price monitoring** — track how a competitor or supplier prices a product range over time. - **Assortment research** — see which brands and products are listed in a category, and at what price. - **Marketplace intelligence** — separate first-party offers from third-party seller offers using the `sellerType` field. - **Deal tracking** — the `originalPrice` field exposes the strike-through "was" price, so you can measure real discount depth. ### How to scrape 220.lv data 1. Open the actor in the Apify Console. 2. Enter a **Search Query** in Latvian (for example `telefons`, `portatīvais dators`, `putekļu sūcējs`, `kafijas automāts`). Alternatively, paste one or more **Start URLs** pointing at a 220.lv search or category page. 3. Set **Max Results** to the number of products you want (the actor paginates automatically, 60 products per page). 4. Leave the proxy configuration at its default. 5. Click **Start**. Results stream into the dataset as they are collected, and can be exported as JSON, CSV, Excel, or fetched through the Apify API. You can also run it programmatically through the Apify API or any of the Apify client libraries. ### Input | Field | Type | Description | |-------|------|-------------| | `searchQuery` | string | What to search for on 220.lv, in Latvian. Used when no start URLs are given. Defaults to `telefons`. | | `startUrls` | array | Optional. 220.lv search or category URLs to scrape instead of the search query (e.g. `https://220.lv/lv/telefoni-un-viedierices`). | | `maxResults` | integer | Maximum number of products to scrape. Default `100`. | | `brightDataApiKey` | string | Optional. Your own unblocking API key. Leave empty to use the built-in one. | | `proxyConfiguration` | object | Proxy settings. Fetching runs through a built-in unblocking service, so the default is fine. | #### Example input ```json { "searchQuery": "telefons", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "LV" } } ```` ### Output Each product is one dataset record with the following fields: | Field | Type | Example | |-------|------|---------| | `name` | string | `Telefons Xiaomi Redmi 15C 4G 4/128GB Midnight Black` | | `brand` | string | `XIAOMI` | | `price` | number | `103.75` | | `currency` | string | `EUR` | | `originalPrice` | number/null | `149` | | `rating` | number/null | `5` | | `reviewCount` | integer/null | `10` | | `sellerType` | string | `1P` (220.lv) or `3P` (marketplace seller) | | `inStock` | boolean | `true` | | `deliveryPromise` | string | `pickup-tomorrow` | | `productId` | integer | `242895061` | | `variantId` | integer | `267950341` | | `categoryId` | integer | `85` | | `imageUrl` | string | `https://lv2.pigugroup.eu/.../..._large.jpg` | | `url` | string | `https://220.lv/lv/telefoni-un-viedierices/...?id=242895061` | | `scrapedAt` | string | `2026-07-07T09:22:56.753Z` | #### Example output ```json { "name": "Telefons Xiaomi Redmi 15C 4G 4/128GB Midnight Black", "brand": "XIAOMI", "price": 103.75, "currency": "EUR", "originalPrice": 149, "rating": 5, "reviewCount": 10, "sellerType": "3P", "inStock": true, "deliveryPromise": "pickup-tomorrow", "productId": 242895061, "variantId": 267950341, "categoryId": 85, "imageUrl": "https://lv2.pigugroup.eu/colours/243/470/441/243470441/xiaomi-redmi-15c-4g-4128gb-midnight-black-35b88_large.jpg", "url": "https://220.lv/lv/telefoni-un-viedierices/telefons-xiaomi-redmi-15c-4g-4128gb-midnight-black?id=242895061", "scrapedAt": "2026-07-07T09:22:56.753Z" } ``` ### Prices and discounts `price` is the current selling price shown on the product card, in euros. When a product is discounted, `originalPrice` holds the higher strike-through "was" price, so `originalPrice - price` is the discount amount. When there is no discount, `originalPrice` is `null`. ### First-party vs marketplace sellers 220.lv is a marketplace, so a search returns a mix of products sold by 220.lv itself and products sold by independent sellers. The `sellerType` field lets you filter: - `1P` — sold and shipped by 220.lv. - `3P` — sold by a third-party marketplace seller. ### Search tips - Search terms should be in **Latvian**, since that is how the catalogue is indexed. `telefons` = phone, `portatīvais dators` = laptop, `televizors` = TV, `putekļu sūcējs` = vacuum cleaner. - To scrape a whole category rather than a search, pass its URL in `startUrls` (for example `https://220.lv/lv/telefoni-un-viedierices`). Category pages use the same layout and paginate the same way. - Results are returned 60 per page. Set `maxResults` to control how deep the actor paginates. ### Cost estimate This actor is billed pay-per-result. One request returns a full page of 60 products, so the per-result cost stays low even for large runs. Scraping a few thousand products across a category is inexpensive; check the live estimate on the actor page for exact numbers. ### Limitations and notes - Data comes from the search and category listings, which cover all the fields above. Deep per-product detail pages (full specs, all images, seller name) are not fetched in this version. - `rating` and `reviewCount` are only present for products that have received reviews. - Prices and availability are captured at scrape time (`scrapedAt`). Re-run the actor to refresh. ### Related Scrapers 220.lv runs on the Pigu Group platform. Build a complete view of Baltic and Nordic online retail with these sibling scrapers from Studio AMBA: - **[Pigu.lt Scraper](https://apify.com/studio-amba/pigu-lt-scraper)** — the largest Lithuanian online marketplace (pigu.lt). - **[Apotheka LV Scraper](https://apify.com/studio-amba/apotheka-lv-scraper)** — Latvian pharmacy products (apotheka.lv). - **[Aruodas Scraper](https://apify.com/studio-amba/aruodas-scraper)** — Lithuanian real estate listings (aruodas.lt). - **[Auto24 EE Scraper](https://apify.com/studio-amba/auto24-ee-scraper)** — Estonian used-car marketplace (auto24.ee). - **[Verkkokauppa Scraper](https://apify.com/studio-amba/verkkokauppa-scraper)** — Finnish electronics retailer (verkkokauppa.com). - Browse the [Apify Store e-commerce category](https://apify.com/store/categories/ecommerce) for more marketplace and retail scrapers from Studio AMBA. ### Your feedback If you notice any data quality issues, missing fields, or broken runs, let us know through the Apify Console. We monitor and update this scraper to keep it reliable. # Actor input Schema ## `searchQuery` (type: `string`): What to search for on 220.lv, in Latvian (e.g. 'telefons', 'portatīvais dators', 'putekļu sūcējs', 'kafijas automāts'). ## `startUrls` (type: `array`): 220.lv search or category URLs to scrape instead of the search query (e.g. https://220.lv/lv/telefoni-un-viedierices). Leave empty to use the search query. ## `maxResults` (type: `integer`): Maximum number of products to scrape. ## `brightDataApiKey` (type: `string`): Optional: your own Bright Data Web Unlocker API key. Leave empty to use the built-in key. ## `proxyConfiguration` (type: `object`): Proxy settings. Fetching goes through a built-in unblocking service, so this can be left at its default. ## Actor input object example ```json { "searchQuery": "telefons", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "LV" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "telefons", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "LV" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/220-lv-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "telefons", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "LV", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/220-lv-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "telefons", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "LV" } }' | apify call studio-amba/220-lv-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/220-lv-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "220.lv Scraper — Latvian Marketplace Products & Prices", "description": "Scrape products from 220.lv, a large Latvian online marketplace (Pigu Group). Extract prices, original prices, brands, ratings, stock and seller type (1P/3P) for any search or category. No cookies or login required.", "version": "0.1", "x-build-id": "qpb4Jg0G5LUvmWrCs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~220-lv-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-220-lv-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~220-lv-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-220-lv-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~220-lv-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-220-lv-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "What to search for on 220.lv, in Latvian (e.g. 'telefons', 'portatīvais dators', 'putekļu sūcējs', 'kafijas automāts')." }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "220.lv search or category URLs to scrape instead of the search query (e.g. https://220.lv/lv/telefoni-un-viedierices). Leave empty to use the search query.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of products to scrape.", "default": 100 }, "brightDataApiKey": { "title": "Bright Data API Key (optional)", "type": "string", "description": "Optional: your own Bright Data Web Unlocker API key. Leave empty to use the built-in key." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Fetching goes through a built-in unblocking service, so this can be left at its default." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```