# Zaplata.bg Scraper - Bulgarian Job Ads with Salary (`studio-amba/zaplata-bg-scraper`) Actor

Scrape job ads from zaplata.bg, a Bulgarian job portal. Get title, employer, city, category, salary range, employment type, posting date, expiry date and the full ad text for every ad on the site.

- **URL**: https://apify.com/studio-amba/zaplata-bg-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 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.
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

## Zaplata.bg Scraper

Pull job ads from zaplata.bg, a Bulgarian job portal. The actor returns one row per ad with the title, employer, city, category, employment type, salary range, posting date, expiry date and the full ad text.

Zaplata.bg ads state a salary range, so the salary fields are filled on almost every row. Use the data to follow hiring by employer, compare pay by role and city, or feed a job board.

### How to scrape Zaplata.bg data

There are two ways to tell the actor which ads to read.

1. Paste ad pages into `jobUrls`, for example `https://www.zaplata.bg/proizvodstvo/plovdiv/704282/skladov-rabotnik/`.
2. Leave `jobUrls` empty and fill `keywords`. The actor reads the site's public list of current ads and keeps ads whose address contains one of your words. The address holds the category, the city and the job title in Latin letters, so `sofia`, `shofior` and `prodavach` all work.

The actor stops at `maxResults`. If you leave everything empty, it reads the first ads in the list.

Write keywords in Latin letters as they appear in the address, for example `plovdiv` or `programist`. English words such as `engineer` work for ads with an English title.

### Input

| Field | Type | Description |
|---|---|---|
| `jobUrls` | list of URLs | zaplata.bg job ad pages |
| `keywords` | list of words | Used when no URLs are given. Keeps ads whose address contains one of the words |
| `maxResults` | number | Maximum number of ads (default 50) |
| `proxyConfiguration` | proxy | Apify Proxy by default |

### What you get back

| Field | Description |
|---|---|
| `jobId` | zaplata.bg ad number from the address |
| `title` | Job title |
| `company` | Employer name |
| `companyWebsite` | Employer website, when the ad gives one |
| `city` | City of the job |
| `region` | Region of the job |
| `category` | Industry and job group as listed by zaplata.bg |
| `categorySlug` | Category part of the ad address |
| `employmentType` | FULL_TIME, PART_TIME, TEMPORARY and similar |
| `salaryMin`, `salaryMax` | Salary range as numbers |
| `salaryPeriod` | month, hour or year |
| `currency` | Currency as stated on the ad |
| `postedDate` | Date the ad was posted |
| `validUntil` | Date the ad expires |
| `description` | Full ad text |
| `logoUrl` | Employer logo, when the ad has one |
| `url` | Ad address |
| `scrapedAt` | Time of the read |
| `country` | `bg` |

### Example output

```json
{
  "jobId": "703920",
  "title": "Oбщ работник",
  "company": "ХАРДИ ЕООД",
  "companyWebsite": null,
  "city": "Варна",
  "region": "Варна",
  "category": "Търговия, Продажби - (Продавачи и помощен персонал)",
  "categorySlug": "prodavachi-i-pomoshten-personal",
  "employmentType": "FULL_TIME, TEMPORARY",
  "salaryMin": 1100,
  "salaryMax": 1200,
  "salaryPeriod": "month",
  "currency": "BGN",
  "postedDate": "2026-10-23",
  "validUntil": "2026-11-20",
  "description": "Нашата компания търси отговорен и мотивиран работник за склада ни...",
  "logoUrl": null,
  "url": "https://www.zaplata.bg/prodavachi-i-pomoshten-personal/varna/703920/obsht-rabotnik/",
  "scrapedAt": "2026-11-06T10:02:29.904Z",
  "country": "bg"
}
```

### Use cases

- Compare salary ranges by role and city in Bulgaria.
- Follow which employers are hiring and how many ads they run.
- Feed a job board or alert service with new Bulgarian ads.
- Track hiring by category, for example production, retail or transport.
- Build a dataset of job descriptions for skills analysis.

### Cost and speed

The actor reads one page per ad, with four requests at the same time. Twenty ads take well under a minute. Pricing is per result, see the pricing box on this page. A run's usage cost only settles after it reports SUCCEEDED.

### Notes and limits

- The site lists about 1,800 current ads. A keyword filter reads only the matching ones.
- `currency` is copied from the ad. Some ads still state BGN, others state EUR.
- Search result pages are not read. The actor uses the site's public ad list.
- Some ads have no employer logo or website. Those fields are empty.
- The actor reads publicly visible pages only. It does not log in and does not use cookies.
- You are responsible for how you use the data. Check zaplata.bg's terms and the rules that apply to your use case.

### Frequently asked questions

#### Does it return salaries?

Yes. The `salaryMin` and `salaryMax` fields hold the range as numbers, `salaryPeriod` says per month, hour or year, and `currency` says which currency the ad uses.

#### Can I filter by city?

Yes. Put the city in `keywords` in Latin letters, for example `plovdiv`. The city is part of the ad address.

#### Can I get ads from one category?

Put the category word in `keywords`, for example `shofiori` for drivers and couriers or `proizvodstvo` for production. Ads from all matching categories are returned.

#### How do I know an ad is still open?

Check `validUntil`. The ad expires on that date.

#### How often can I run it?

As often as you like. Daily runs give a clean view of new and expired ads.

### Related scrapers

- [Jobs.bg Scraper](https://apify.com/studio-amba/jobs-bg-scraper) for Jobs.bg job ads
- [CV.lt Scraper](https://apify.com/studio-amba/cv-lt-scraper) for Lithuanian job ads
- [Kariera.sk Scraper](https://apify.com/studio-amba/kariera-sk-scraper) for Slovak job ads

# Actor input Schema

## `jobUrls` (type: `array`):

Job ad pages from zaplata.bg, for example https://www.zaplata.bg/proizvodstvo/plovdiv/704282/skladov-rabotnik/. When empty, the actor reads the site's list of current ads.

## `keywords` (type: `array`):

Used when no job ad URLs are given. Keeps ads whose address contains one of these words. The address holds the category, the city and the job title in Latin letters, for example prodavach, shofior, sofia, varna or programist. Leave empty to read the first ads in the list.

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

Maximum number of job ads to return.

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

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "keywords": [
    "prodavach"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (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 = {
    "keywords": [
        "prodavach"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/zaplata-bg-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 = {
    "keywords": ["prodavach"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/zaplata-bg-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 '{
  "keywords": [
    "prodavach"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/zaplata-bg-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/zaplata-bg-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/cXPkbCxFcQkAMDqLJ/builds/Wp4wSimt1IWxabi74/openapi.json
