# Deal.by Scraper — Belarus Marketplace Products & Prices (`logiover/deal-by-marketplace-scraper`) Actor

Scrape Deal.by, Belarus' largest marketplace, in bulk: product name, price in BYN, old price, seller name and link, product image and promoted flag as sortable columns. Category browse or keyword search. No login, no API key.

- **URL**: https://apify.com/logiover/deal-by-marketplace-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Deal.by Scraper — Belarus Marketplace Products & Prices

Scrape **Deal.by**, Belarus's largest online marketplace, in bulk — **no login, no API key, no browser**. Point the Actor at any category or result page and it walks the pages, parses every card into flat, sortable columns, and saves rows as it goes.

> **13 columns per row** · thousands of rows per run · numeric prices, not strings · JSON, CSV, Excel or API · pay only for the rows you keep.

***

### Why this Deal.by scraper

Deal.by publishes everything a buyer needs on the result page — but as prose, inside a card, behind pagination. Reading it at any useful scale by hand is not realistic, and copy-paste gives you text where you need numbers.

This Actor turns those pages into a table. **`price` is a number**, not a formatted string. Location, seller and category are their own columns instead of one blob. That is the difference between data you can pivot on and data you have to clean first.

It is built on the same engine as the rest of this fleet, which means three things you only notice when they are missing:

- **It respects the clock.** Every run carries a time budget and saves rows continuously, so a slow page never costs you the whole run.
- **One bad page does not end the crawl.** An unreachable page is retried, then skipped and logged — not treated as the end of the listing.
- **It says what it did.** Row counts, skipped pages and stop reasons all appear in the log, so a short run is always explainable.

***

### What you get

#### Price monitoring in Belarus

Deal.by is Belarus' largest marketplace. `price` arrives as a number in Belarusian ruble, so you can chart it daily and detect pricing moves across the market.

#### Supplier and seller discovery

Every row carries `companyName` and `companyUrl`, letting you build a supplier directory from any product category in the Belarusian market.

#### Discount tracking

`oldPrice` captures the previous price, so you can filter for active promotions and measure discount depth by category.

#### Market research for a hard-to-reach economy

Belarus is thinly covered by Western data platforms. A category walk gives you the actual assortment with prices and sellers — data that would otherwise require local sourcing.

***

### Input

| Field | Type | What it does |
|---|---|---|
| `startUrl` | string | Any Deal.by category or result URL. The Actor paginates from here. |
| `searchQuery` | string | Optional keyword. When set, the site is searched for it and the category URL is ignored. |
| `maxResults` | integer | Stop after this many rows (default 200). |
| `proxyConfiguration` | object | Apify Proxy settings. The default is fine. |

#### Example input

```json
{
  "startUrl": "https://deal.by/Smartfony",
  "searchQuery": "",
  "maxResults": 200,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

***

### Output

One row per product, 13 columns:

| Column | Type | Description |
|---|---|---|
| `productId` | string | Deal.by product id. |
| `title` | string | Product name. |
| `productUrl` | string | Canonical product page. |
| `price` | number | Current price in Belarusian ruble. |
| `oldPrice` | number | Struck-through price before discount. Null when there is no discount. |
| `currency` | string | Always BYN. |
| `companyName` | string | Company or shop name. |
| `companyUrl` | string | Deal.by storefront link. |
| `imageUrl` | string | Product image. |
| `isPromoted` | boolean | True when the listing is a paid placement. |
| `country` | string | Always Belarus. |
| `source` | string | Always deal\_by. |
| `scrapedAt` | string | ISO timestamp of collection. |

#### Example row

```json
{
  "productId": "…",
  "title": "…",
  "productUrl": "…",
  "price": 0,
  "oldPrice": 0,
  "currency": "…",
  "companyName": "…",
  "companyUrl": "…",
  "imageUrl": "…",
  "isPromoted": false,
  "country": "…",
  "source": "…",
  "scrapedAt": "…"
}
```

Export from the Apify Console as **JSON, CSV, Excel, XML or RSS**, or pull it straight from the [Dataset API](https://docs.apify.com/api/v2#/reference/datasets/item-collection/get-items).

***

### How to use it

1. Open the Actor and paste a Deal.by category URL into **Category or listing URL**.
2. Set **Maximum results** to how many rows you want.
3. Click **Start**. Rows appear in the dataset while the run is still going.
4. Export, or schedule the run daily and diff the results to track price moves.

You can also run it from the [Apify API](https://docs.apify.com/api/v2), the [JavaScript client](https://docs.apify.com/api/client/js/) or the [Python client](https://docs.apify.com/api/client/python/), and wire the output into Google Sheets, Zapier, Make or your own warehouse.

***

### Frequently asked questions

**Do I need an account or API key?**

No. Everything comes from Deal.by's public result pages.

**Can I search by keyword?**

Yes. Fill in **Search keyword** to run a Deal.by search instead of walking a category.

**Which currency?**

Belarusian ruble (BYN), stated explicitly in the `currency` column.

**Is `price` a number or text?**

A number. It is parsed from the machine-readable `data-qaprice` attribute, so you can sort and average it directly.

**How do I choose a category?**

Paste any Deal.by category URL as the start URL; the Actor paginates from there.

**How much does it cost?**

You pay per row kept, plus Apify platform usage. A 1,000-row run is inexpensive; run it on a schedule and you have a continuous price feed for the cost of a coffee.

**Is scraping Deal.by legal?**

This Actor reads only publicly available pages — the same ones anyone can open in a browser — and collects no personal data beyond the seller display name that Deal.by itself publishes next to each listing. You are responsible for how you use the output, including compliance with Deal.by's terms and with data-protection law such as the GDPR. If in doubt, take legal advice.

***

### Related Actors

Browse the rest of the fleet for country marketplace, classifieds, property and company-registry scrapers covering more than eighty countries.

***

### Support

Found a broken column or a site change? Open an issue on the Actor's **Issues** tab and it will be looked at. This Actor is actively maintained — see the Changelog for its history.

***

*Deal.by is a trademark of its respective owner. This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Deal.by.*

# Actor input Schema

## `startUrl` (type: `string`):

Any Deal.by category or result URL. The Actor walks its pages from here. Example: https://deal.by/Smartfony

## `searchQuery` (type: `string`):

Optional. When set, Deal.by is searched for this keyword and the category URL above is ignored.

## `maxResults` (type: `integer`):

Stop after this many rows. The Actor walks pages until the target is met, the listing runs out, or the run's time budget is spent.

## `proxyConfiguration` (type: `object`):

Deal.by serves plain HTML; the default Apify Proxy is enough.

## Actor input object example

```json
{
  "startUrl": "https://deal.by/Smartfony",
  "searchQuery": "",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with one row per Deal.by listing.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrl": "https://deal.by/Smartfony",
    "searchQuery": "",
    "maxResults": 200,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/deal-by-marketplace-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrl": "https://deal.by/Smartfony",
    "searchQuery": "",
    "maxResults": 200,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("logiover/deal-by-marketplace-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrl": "https://deal.by/Smartfony",
  "searchQuery": "",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call logiover/deal-by-marketplace-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,logiover/deal-by-marketplace-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/f4MYTNjP5w4YXS4K3/builds/uJDMhzqJQ3RKluBWr/openapi.json