# DEV.BG Bulgarian IT Jobs Scraper (`parseforge/devbg-bulgarian-jobs-scraper`) Actor

Scrapes DEV.BG job listings by keyword or category and returns each job as a flat row with title, company, location, and description.

- **URL**: https://apify.com/parseforge/devbg-bulgarian-jobs-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 1 total users, 1 monthly users, 90.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $19.00 / 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### DEV.BG Bulgarian IT Jobs Scraper

**Scrape Bulgarian IT job listings from DEV.BG by keyword or category, up to a million per run.** Each job comes with its title, company, location, and full description. No login or API key. Export to CSV, JSON, Excel, or XML.

DEV.BG is Bulgaria's leading tech job board, but browsing it manually means missing new postings and losing hours to copy-paste. This Actor reads the public job listings directly, filtered by keyword or role category, and returns each match in one fixed schema. It is built for recruiters, analysts, and job seekers who need fresh Bulgarian IT job data without the official API's limits.

| Who uses it | What they scrape DEV.BG for |
|---|---|
| Recruiters and talent sourcers | Build a live pipeline of Bulgarian IT openings to match candidates faster |
| Market researchers | Track which technologies and roles Bulgarian companies are hiring for |
| Job seekers | Get a daily digest of new DEV.BG listings that match their skills |
| HR analytics teams | Monitor salary trends and hiring volume across Bulgarian tech hubs |

### What it does

This Actor collects DEV.BG job listings by keyword or category, and returns each one as a flat row with title, company, location, and description.

- 🔍 **Keyword search:** free-text query like python, java, or react, or leave empty for all jobs.
- 🗂️ **Category filter:** pick from 16 role categories, from Backend Development to Game Development.
- 📦 **Bulk collection:** set maxItems up to 1,000,000 to pull the whole board in one run.
- 📄 **Flat output:** every job is one row, ready for CSV, JSON, Excel, or XML export.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with DEV.BG data

**📈 Track hiring trends in Bulgarian tech.**

A market researcher runs the Actor weekly with no keyword to collect all DEV.BG listings, then charts which categories and skills are growing.

**🎯 Build a candidate pipeline.**

A recruiter filters by Backend Development and keyword python, exports the CSV, and imports it into their ATS to source active candidates.

**📬 Get a personal job digest.**

A job seeker schedules a daily run for react and Frontend Development, then reads the JSON output to apply to new postings first.

**🧹 Clean competitor intelligence.**

An HR analyst scrapes all listings monthly, deduplicates by company, and reports on which firms are hiring most aggressively.

### Why choose this scraper

|  | What you get |
|---|---|
| **No API key** | Reads the public DEV.BG board directly, no registration or OAuth |
| **Fresh data** | Each run pulls the latest listings, so your dataset never goes stale |
| **One schema** | Every job returns the same fields, no matter the filter |
| **Bulk ready** | Collect up to a million listings in a single run |

### How it compares

This Actor focuses on keyword and category filtering with bulk collection, while the competitor adds city, seniority, and work mode filters.

| Feature | ParseForge | Dev.bg Scraper |
|---|---|---|
| Keyword search | Yes | Not listed |
| Category filter | Yes | Yes |
| City filter | Not listed | Yes |
| Seniority filter | Not listed | Yes |
| Work mode filter | Not listed | Yes |
| Bulk collection up to 1,000,000 | Yes | Not listed |

### Configure the run

Drive the Actor from a keyword, a category, or both, and set maxItems to cap how many listings come back per run. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "maxItems": 10
}
```

A larger pull:

```json
{
  "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.021 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [DEV.BG Bulgarian IT Jobs Scraper](https://apify.com/parseforge/devbg-bulgarian-jobs-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to DEV.BG through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/devbg-bulgarian-jobs-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Make sure your searchQuery is spelled correctly and your category filter is not too narrow. Try leaving both empty to see all jobs.

**Why did the run stop before reaching maxItems?**

The Actor stops when it has collected all available listings. If the board has fewer jobs than maxItems, you will get everything that exists.

**Why are some job descriptions missing?**

Some listings may have truncated or hidden descriptions on the public board. The Actor returns whatever text is visible without login.

**Can I filter by remote work?**

Remote work is not a separate filter in this version. Use the keyword search to look for terms like remote or hybrid in the job title.

**Why is the run slow?**

Large maxItems values mean more pages to fetch. Reduce maxItems or narrow your filters to speed up the run.

### FAQ

| Question | Answer |
|---|---|
| Do I need a DEV.BG account or API key? | No. The Actor reads the public job board directly, so no login or registration is required. |
| Can I filter by city or seniority? | The current input supports keyword and category only. City and seniority filters are not available in this version. |
| How many jobs can I collect in one run? | You can set maxItems up to 1,000,000. The actual number returned depends on how many listings match your filters. |
| What does each job record include? | Each row includes the job title, company, location, and full description, plus any other fields the board exposes. |
| Can I schedule this Actor to run automatically? | Yes. Use Apify Schedules to run it daily, weekly, or at any interval, and get fresh listings without manual triggers. |
| What export formats are supported? | You can export the results to CSV, JSON, Excel, or XML directly from the Apify dataset. |
| Is this Actor legal to use? | It only reads publicly available job listings. Always respect DEV.BG's terms of service and robots.txt for your use case. |
| Can I search for multiple keywords at once? | The searchQuery field accepts a single string. For multiple terms, run the Actor once per keyword or combine results afterward. |
| Does the Actor handle pagination? | Yes. It automatically follows pagination to collect up to maxItems listings, so you do not need to manage pages. |
| What if I get no results? | Check your keyword spelling and category selection. If the board has no matching jobs, the dataset will be empty. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by DEV.BG Ltd. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

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

Free-text keyword search (e.g. python, java, react). Leave empty for all jobs.

## `maxItems` (type: `integer`):

How many job listings to collect per run.

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

Filter to a specific role category. Leave empty for all.

## Actor input object example

```json
{
  "searchQuery": "",
  "maxItems": 10,
  "category": ""
}
```

# 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 = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/devbg-bulgarian-jobs-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 = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/devbg-bulgarian-jobs-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 '{
  "maxItems": 10
}' |
apify call parseforge/devbg-bulgarian-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/devbg-bulgarian-jobs-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/eLH0V4IWodsRlAVNt/builds/RAPMXm7kudSekshP3/openapi.json