# Birmarket Scraper (`aboo.script/birmarket-az-scraper`) Actor

Scrape Birmarket.az (formerly Umico), the largest online marketplace in Azerbaijan: products by keyword or category, brand, seller, search or product URL with prices in AZN, discounts, all seller offers, ratings, specifications and images.

- **URL**: https://apify.com/aboo.script/birmarket-az-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Birmarket Scraper

![Birmarket Scraper](https://i.ibb.co/qM9VTX8G/birmarket-az-banner.png)

**Birmarket Scraper** extracts product data from [Birmarket](https://birmarket.az/) (formerly Umico), the largest online marketplace in Azerbaijan, into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a Birmarket category, search, brand, seller, or product URL, or type a few keywords, and get the title, price in AZN, discount, every seller offer, rating, specifications, description, and images for every product. No account or login required.

### Introduction

[Birmarket](https://birmarket.az/) is Azerbaijan's biggest e-commerce marketplace, with more than 500,000 products from hundreds of local sellers: phones, electronics, home appliances, beauty, fashion, groceries, and more, with delivery across the country and installment plans. Its catalog is one of the best sources of consumer prices and seller competition in the Azerbaijani market.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from Birmarket?

- 🏷️ Product title, product ID, SKU (manufacturer part number) and barcode (GTIN)
- 🏭 Brand, category name and category ID
- 💲 Price, original price and discount percentage in AZN, plus discount start and end dates when the site shows them
- 📦 Availability, minimum order quantity, pre-order, refurbished and return policy flags
- ⭐ Rating, number of ratings and number of reviews
- 🏢 Seller name, seller ID, seller rating, seller type, VAT payer status and logo
- 🛒 All seller offers for the same product, each with its own price, original price, discount and installment plan
- 💳 Installment availability and maximum number of installment months
- 📋 Full specifications (name and value), such as memory, color, screen size or country of origin
- 📝 Plain-text description and product labels (such as "New")
- 🖼️ Main image, full image gallery and product videos
- 🌐 Azerbaijani or Russian texts
- 🔗 Direct URL to each product

### Use Cases

- 📈 **Market research**: track consumer prices and discounts in Azerbaijan across categories and brands.
- 🕵️ **Competitor monitoring**: see which sellers offer the same product and who has the lowest price.
- 🤝 **Lead generation**: build a list of Birmarket sellers and brands active in a category.
- 🗂️ **Database building**: create your own product catalog with specifications, barcodes and images.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Birmarket step by step

1. Paste one or more Birmarket URLs into **Start URLs**, or type keywords into **Search queries**.
2. Set **Maximum number of results** to how many products you want per URL or per query.
3. Optionally choose **Sort by**, a price range, **Discounted products only**, **Official sellers only** and **Language** for your search queries.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Birmarket URLs to scrape. Supported pages: categories (`https://birmarket.az/categories/3-mobil-telefonlar-ve-smartfonlar`), search pages (`https://birmarket.az/search/iphone`), brands (`https://birmarket.az/brands/apple`), sellers (`https://birmarket.az/merchant/14174-electro-world`) and single product pages (`https://birmarket.az/product/960844-...`). Russian pages (`https://birmarket.az/ru/...`) return Russian texts. Any filters and sorting in the URL (such as price range, discounted products, official sellers, brand, specifications, or price order) are kept in the results.
- **Search queries**: keywords to search on Birmarket, one per line. Each query is scraped separately.
- **Maximum number of results**: how many products to collect for each start URL or search query. Use 0 for no limit.
- **Sort by**: order of the search results (most relevant, most popular, price low to high, price high to low, top rated). Applies to search queries only.
- **Minimum price (AZN)** and **Maximum price (AZN)**: only products within this price range. Apply to search queries only.
- **Discounted products only**: only products with a discount. Applies to search queries only.
- **Official sellers only**: only products sold by official brand sellers. Applies to search queries only.
- **Language**: Azerbaijani or Russian titles, categories and specifications for search queries. Start URLs use the language of the URL.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape a category page from Birmarket:

```json
{
  "startUrls": [{ "url": "https://birmarket.az/categories/3-mobil-telefonlar-ve-smartfonlar" }],
  "maxResults": 5
}
```

Search by keywords, cheapest first, discounted products within a price range, in Russian:

```json
{
  "searchQueries": ["iphone", "televizor"],
  "sortBy": "priceAsc",
  "minPrice": 500,
  "maxPrice": 1000,
  "onlyDiscounted": true,
  "language": "ru",
  "maxResults": 5
}
```

### Output

Each product is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://birmarket.az/product/1321245-smartfon-xiaomi-redmi-15c-4gb-128gb-midnight-black",
  "id": 1321245,
  "title": "Smartfon Xiaomi Redmi 15C 4GB/128GB Midnight Black",
  "sku": null,
  "gtin": "6932554444822",
  "brand": "Xiaomi",
  "category": "Mobil telefonlar və smartfonlar",
  "categoryId": 3,
  "price": 398.89,
  "originalPrice": 599,
  "discountPercent": 33,
  "currency": "AZN",
  "discountStartDate": null,
  "discountEndDate": null,
  "availability": "In Stock",
  "minOrderQuantity": 1,
  "preorderAvailable": false,
  "isRefurbished": false,
  "isRefundable": true,
  "rating": 4.3,
  "ratingCount": 81,
  "reviewCount": 56,
  "seller": {
    "name": "VNS Electronics",
    "id": 4595,
    "rating": 100,
    "type": "Marketplace seller",
    "vatPayer": true,
    "logo": "https://storage.umico.az/cpcustomerprod01/23bb17d24496e871a490a28945d0976d.jpg"
  },
  "installmentAvailable": true,
  "maxInstallmentMonths": 3,
  "labels": [],
  "offersCount": 5,
  "offers": [
    {
      "seller": {
        "name": "Minor Smart",
        "id": 8399,
        "rating": 96,
        "type": "Marketplace seller",
        "vatPayer": true,
        "logo": "https://storage.umico.az/cpcustomerprod01/b166d3e558aea16abc9063a7a9ee5bf3.jpg"
      },
      "price": 398.94,
      "originalPrice": 499,
      "discountPercent": 20,
      "installmentAvailable": true,
      "maxInstallmentMonths": 3,
      "labels": []
    }
  ],
  "specifications": [
    { "name": "Seriya", "value": "Xiaomi Redmi 15C" },
    { "name": "Operativ yaddaşın həcmi", "value": "4 Gb" },
    { "name": "Daxili yaddaş həcmi", "value": "128 Gb" },
    { "name": "Rəng", "value": "Qara" },
    { "name": "Əməliyyat sistemi", "value": "Android" }
  ],
  "description": "Xiaomi Redmi 15C 4GB/128GB Midnight Black smartfonu 6,9 düym ekran diaqonalına və 1600 x 720 çözünürlüyə malik müasir bir cihazdır...",
  "image": "https://strgimgr.umico.az/img/product/1680/27382da3-b4af-43c5-8243-f24019fdabfa.jpeg",
  "images": [
    "https://strgimgr.umico.az/img/product/1680/27382da3-b4af-43c5-8243-f24019fdabfa.jpeg",
    "https://strgimgr.umico.az/img/product/1680/23c25823-0758-4e22-8d0e-d7dfefa487ee.jpeg"
  ],
  "videos": [],
  "language": "az"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Birmarket shows at most 90,000 products for a single category, search, brand or seller. To collect more, split a large category into its sub-categories or add filters.
- The top-level fields (price, seller, installment) describe the offer Birmarket shows first on the product page; `offers` lists every seller that sells the same product.
- Filter values for specifications depend on the page language, so copy filtered URLs from the same language version you want to scrape.
- Birmarket search also matches similar words, so a search can return products even when no title contains your exact keyword.
- Prices are in Azerbaijani manat (AZN). The rating is `null` when nobody has rated the product yet.

### Why use the Birmarket Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🎯 **Keeps your filters**: paste any category, search, brand, or seller URL from your browser and get exactly what you see there.
- 🛒 **All sellers in one item**: compare every seller's price for the same product without opening each page.
- 🧹 **Clean data**: prices and ratings are real numbers, descriptions are plain text, and every product has the same fields.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of products (up to 90,000 per category, search, brand or seller).

#### Do I need a Birmarket account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape Umico URLs?

Umico is now Birmarket. Open the same page on birmarket.az and paste that URL.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh prices automatically.

#### Why are some fields empty?

Some products simply do not show every piece of information, such as a brand, a barcode, or a description. When a field is not available on the website, it is returned as `null`.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, search queries, sorting, a price range, discounted products, official sellers and language. If you need other filters or data, such as product reviews or delivery options, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Birmarket](https://birmarket.az/)

# Actor input Schema

## `startUrls` (type: `array`):

Birmarket URLs: categories (https://birmarket.az/categories/3-mobil-telefonlar-ve-smartfonlar), search pages (https://birmarket.az/search/iphone), brands (https://birmarket.az/brands/apple), sellers (https://birmarket.az/merchant/14174-electro-world) or product pages (https://birmarket.az/product/960844-...). Russian pages (https://birmarket.az/ru/...) return Russian texts. Filters and sorting in the URL are applied.

## `searchQueries` (type: `array`):

Keywords to search on Birmarket (e.g. iphone, televizor). Each query is scraped separately.

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

Maximum number of products to scrape per start URL or search query. Use 0 for no limit (a single listing returns at most 90,000 products).

## `sortBy` (type: `string`):

Order of the search results. Applies to search queries only; start URLs keep their own sorting.

## `minPrice` (type: `integer`):

Only products priced at or above this amount in Azerbaijani manat. Applies to search queries only.

## `maxPrice` (type: `integer`):

Only products priced at or below this amount in Azerbaijani manat. Applies to search queries only.

## `onlyDiscounted` (type: `boolean`):

Only products with a discount. Applies to search queries only.

## `onlyOfficialSellers` (type: `boolean`):

Only products sold by official brand sellers. Applies to search queries only.

## `language` (type: `string`):

Language of product titles, categories and specifications for search queries. Start URLs use the language of the URL.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://birmarket.az/categories/3-mobil-telefonlar-ve-smartfonlar"
    }
  ],
  "maxResults": 5,
  "sortBy": "relevance",
  "onlyDiscounted": false,
  "onlyOfficialSellers": false,
  "language": "az"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "startUrls": [
        {
            "url": "https://birmarket.az/categories/3-mobil-telefonlar-ve-smartfonlar"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/birmarket-az-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 = { "startUrls": [{ "url": "https://birmarket.az/categories/3-mobil-telefonlar-ve-smartfonlar" }] }

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/birmarket-az-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 '{
  "startUrls": [
    {
      "url": "https://birmarket.az/categories/3-mobil-telefonlar-ve-smartfonlar"
    }
  ]
}' |
apify call aboo.script/birmarket-az-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/birmarket-az-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/mJKXXjDrrqnes8Cuq/builds/ZvXsQEHfr0yjuDTab/openapi.json
