# Jobs.bg Scraper - Bulgarian Job Board Extractor (`studio-amba/jobs-bg-scraper`) Actor

Scrape job listings from Jobs.bg, Bulgaria's largest job board with 36,000+ active postings. Search by keyword, location, and category. Extract job titles, companies, salaries, locations, descriptions, and requirements. No login or cookies required.

- **URL**: https://apify.com/studio-amba/jobs-bg-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **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/platform/actors/running/actors-in-store#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

### What does Jobs.bg Scraper do?

**Jobs.bg Scraper** extracts job listings from [Jobs.bg](https://www.jobs.bg), Bulgaria's largest and most popular job board with over 36,000 active job postings. The scraper searches for jobs by keyword, location, and category, then returns structured data including job titles, companies, salaries, locations, descriptions, and requirements.

Run it on the Apify platform to get **API access, scheduling, proxy rotation, webhook integrations, and monitoring** out of the box. No login or cookies required -- all data is extracted from publicly available job listings.

### Why use Jobs.bg Scraper?

- **Market research**: Analyze the Bulgarian job market by sector, salary ranges, and demand for specific skills.
- **Recruitment intelligence**: Monitor competitor hiring patterns across Bulgaria.
- **Salary benchmarking**: Collect salary data from thousands of Bulgarian job postings.
- **Job aggregation**: Feed Bulgarian job listings into your own job board or aggregator platform.
- **Academic research**: Study employment trends, skill demand, and labor market dynamics in Bulgaria.
- **Lead generation**: Identify actively hiring companies in Bulgaria for B2B outreach.

### How to scrape Jobs.bg data

1. Go to the Jobs.bg Scraper page on Apify Store.
2. Click **Try for free** to open the Actor in Apify Console.
3. Enter your search keyword (e.g. "developer", "marketing", or Bulgarian terms like "инженер").
4. Optionally set a location (Sofia, Plovdiv, Varna, etc.) and category.
5. Set the maximum number of results you want.
6. Click **Start** and wait for the run to finish.
7. Download your data as JSON, CSV, Excel, or connect it to your workflow via API.

That's it -- no coding required. The scraper handles pagination, proxy rotation, and data extraction automatically.

### Input

| Field | Type | Description | Default |
|-------|------|-------------|---------|
| `searchQuery` | String | Job search keyword (English or Bulgarian) | `developer` |
| `location` | String | City or region (Sofia, Plovdiv, Varna, Bourgas, Remote, etc.) | All Bulgaria |
| `category` | String | Job category (IT, Finance, Marketing, Engineering, etc.) | All categories |
| `language` | String | Site language (`en` for English, `bg` for Bulgarian) | `en` |
| `maxResults` | Integer | Maximum number of listings to scrape (1-10,000) | `100` |
| `includeDetails` | Boolean | Visit detail pages for full descriptions (slower) | `false` |
| `proxyConfiguration` | Object | Proxy settings (residential recommended) | Apify Residential |

#### Example input

```json
{
    "searchQuery": "software engineer",
    "location": "Sofia",
    "maxResults": 50,
    "language": "en",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}
```

### Output

The scraper outputs structured JSON data for each job listing. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Example output

```json
{
    "jobTitle": "Senior Software Developer",
    "company": "TechCorp Bulgaria",
    "companyUrl": "https://www.jobs.bg/en/company/techcorp-bulgaria",
    "location": "Sofia",
    "salary": "4000 - 7000 BGN",
    "jobType": "Full-time",
    "category": "IT / Software",
    "postedDate": "09.06.2026",
    "jobDescription": "We are looking for an experienced software developer to join our team...",
    "requirements": "5+ years experience in Java or Python, Bachelor's degree in CS...",
    "url": "https://www.jobs.bg/en/job/8438513",
    "sourceId": "8438513",
    "scrapedAt": "2026-06-09T12:00:00.000Z"
}
```

### Data fields

| Field | Description |
|-------|-------------|
| `jobTitle` | Job position title |
| `company` | Hiring company name |
| `companyUrl` | Link to company profile on Jobs.bg |
| `location` | Job location (city or region) |
| `salary` | Salary range if displayed (BGN or EUR) |
| `jobType` | Employment type (Full-time, Part-time, Remote, etc.) |
| `category` | Job category or sector |
| `postedDate` | Publication date of the listing |
| `jobDescription` | Description text (full with `includeDetails` enabled) |
| `requirements` | Job requirements and qualifications (with `includeDetails`) |
| `url` | Direct link to the job listing |
| `sourceId` | Jobs.bg internal job ID |
| `scrapedAt` | ISO 8601 timestamp of data collection |

### How much does it cost to scrape Jobs.bg?

The Jobs.bg Scraper uses Playwright with residential proxies for reliable data extraction. Typical costs:

- **100 listings** (search results only): ~$0.10-0.20 in platform credits
- **100 listings** (with full details): ~$0.30-0.50 in platform credits
- **1,000 listings** (search results only): ~$0.50-1.00 in platform credits

Costs depend on the number of pages loaded and proxy usage. Disabling `includeDetails` is faster and cheaper when you only need basic listing data.

### Tips and advanced options

- **Use Bulgarian keywords** for broader results. Many listings are in Bulgarian only (e.g. "програмист" instead of "programmer").
- **Enable `includeDetails`** only when you need full job descriptions and requirements. It's 5-10x slower because it visits each job page individually.
- **Set `maxResults`** to control costs. Start small (10-50) to verify the output, then scale up.
- **Location filtering** supports major Bulgarian cities: Sofia, Plovdiv, Varna, Bourgas, Ruse, Stara Zagora, Pleven, and 20+ more. Use "Remote" for remote-only jobs.
- **Schedule runs** to track new listings daily or weekly using Apify's built-in scheduler.
- **Combine with other scrapers** to build a comprehensive Bulgarian job market dataset. Check our Zaplata.bg and Karieri.bg scrapers.

### Supported locations

Sofia, Plovdiv, Varna, Bourgas (Burgas), Ruse, Blagoevgrad, Pleven, Stara Zagora, Dobrich, Sliven, Shumen, Pernik, Haskovo, Yambol, Pazardzhik, Veliko Tarnovo, Vratsa, Gabrovo, Kardzhali, Vidin, Montana, Targovishte, Lovech, Razgrad, Silistra, Smolyan, Kyustendil, and Remote work.

### FAQ and support

#### Is it legal to scrape Jobs.bg?

This scraper extracts only publicly available job listing data that any visitor can see without logging in. It does not access private data, bypass authentication, or violate GDPR. Always review the website's Terms of Service before large-scale scraping and ensure your use case complies with applicable laws.

#### The scraper returns 0 results

- Make sure your search query matches actual job listings on Jobs.bg.
- Try broader search terms or remove location/category filters.
- Ensure residential proxies are enabled in the proxy configuration.
- The site may temporarily block automated access -- try again after a few minutes.

#### Can I get custom modifications?

Yes. If you need additional fields, different output formats, or integration with your systems, open an issue in the **Issues** tab or contact us for a custom solution.

#### How often should I run this scraper?

Jobs.bg updates listings continuously. For most use cases, running once daily or weekly is sufficient. Use Apify's scheduler to automate recurring runs.

# Actor input Schema

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

Job search keyword (e.g. 'developer', 'marketing', 'инженер'). Supports both English and Bulgarian. Defaults to 'developer' if empty.

## `location` (type: `string`):

City or region name (e.g. 'Sofia', 'Plovdiv', 'Varna', 'Bourgas'). Leave empty for all Bulgaria.

## `category` (type: `string`):

Job category filter. Leave empty for all categories.

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

Site language for results.

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

Maximum number of job listings to scrape.

## `includeDetails` (type: `boolean`):

Visit each job detail page to extract full description and requirements. Slower but provides richer data.

## `brightDataApiKey` (type: `string`):

Your Bright Data API key for the Web Unlocker zone. Optional -- only needed if you run this actor on your own Bright Data account. Jobs.bg uses Cloudflare + DataDome anti-bot protection.

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

Proxy settings (kept for compatibility -- requests are routed through Bright Data Web Unlocker, so this setting is not used).

## Actor input object example

```json
{
  "searchQuery": "developer",
  "category": "",
  "language": "en",
  "maxResults": 100,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "searchQuery": "developer",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/jobs-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 = {
    "searchQuery": "developer",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=studio-amba/jobs-bg-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/F82UDFpS9ES8ggEqe/builds/86fjZU7B1EFiChq0u/openapi.json