# Dev.bg Scraper (`unfenced-group/devbg-scraper`) Actor
Extract IT job listings from DEV.bg — Bulgaria's leading tech job board. Filter by category, city, seniority, and work mode.
- **URL**: https://apify.com/unfenced-group/devbg-scraper.md
- **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.49 / 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.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
## DEV.bg Scraper
Extract job listings from [DEV.bg](https://dev.bg) — Bulgaria's leading IT job board. Collect job titles, descriptions, tech stack, seniority, locations, work mode, and company details at scale.
### Features
- **Full job board coverage** — scrape all ~1,600+ active IT job listings
- **Rich taxonomy data** — categories, tech stack, seniority level, work mode, city
- **Keyword & filter search** — filter by job category, city, seniority, work mode, and date
- **Company details** — optional detail-page fetch for company name and profile URL
- **Cross-run deduplication** — skip already-seen jobs across scheduled runs (90-day memory)
- **Start URLs** — scrape specific job listings directly
### Input
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `keyword` | string | — | Search keyword (title/description) |
| `category` | enum | — | Job category (e.g. `python`, `devops`, `java`) |
| `seniority` | enum | — | Seniority level (`junior`, `mid-level`, `senior`, `lead`) |
| `location` | enum | — | City filter (`sofiya`, `plovdiv`, `varna`, …) |
| `workMode` | enum | — | Work mode (`fully-remote`, `hybrid`) — only when no city is selected |
| `postedAfter` | string | — | ISO date, e.g. `2025-01-01` |
| `fetchDetails` | boolean | `false` | Fetch company name and URL from detail page |
| `skipDuplicates` | boolean | `false` | Skip jobs seen in previous runs |
| `maxItems` | integer | `0` | Max results (0 = unlimited) |
| `startUrls` | array | — | Specific DEV.bg job URLs to scrape |
#### Example input — Python senior jobs in Sofia
```json
{
"category": "python",
"seniority": "senior",
"location": "sofiya",
"fetchDetails": true,
"maxItems": 50
}
````
#### Example input — all remote jobs since January 2025
```json
{
"workMode": "fully-remote",
"postedAfter": "2025-01-01",
"skipDuplicates": false
}
```
### Output
Each item in the dataset represents one job listing:
```json
{
"jobId": 524661,
"title": "Java Developer, Live Casino",
"url": "https://dev.bg/company/jobads/egt-digital-java-developer-live-casino/",
"companyName": "EGT Digital",
"companyUrl": "https://dev.bg/company/egt-digital/",
"datePosted": "2026-04-09",
"dateModified": "2026-04-09",
"description": "We are looking for a Java Developer...
",
"excerpt": "We are looking for a Java Developer to join our Live Casino team.",
"categories": ["Backend Development", "Java"],
"seniority": "2-5 години опит",
"locations": ["София"],
"workMode": "on-site",
"techStack": ["Java", "Spring Boot", "PostgreSQL", "Git"],
"salaryMin": null,
"salaryMax": null,
"salaryCurrency": null,
"salaryPeriod": null
}
```
#### Output fields
| Field | Type | Description |
|-------|------|-------------|
| `jobId` | number | DEV.bg internal job ID |
| `title` | string | Job title |
| `url` | string | Direct URL to the job listing |
| `companyName` | string | null | Company name (requires `fetchDetails: true`) |
| `companyUrl` | string | null | Company profile URL (requires `fetchDetails: true`) |
| `datePosted` | string | Date posted (YYYY-MM-DD) |
| `dateModified` | string | Date last modified (YYYY-MM-DD) |
| `description` | string | Full job description (HTML) |
| `excerpt` | string | Short job description (plain text) |
| `categories` | string\[] | Job categories |
| `seniority` | string | null | Seniority level label |
| `locations` | string\[] | Cities where the job is located |
| `workMode` | string | null | `fully-remote`, `hybrid`, or `on-site` |
| `techStack` | string\[] | Technologies and skills listed |
| `salaryMin` | null | Salary data not published by DEV.bg |
| `salaryMax` | null | Salary data not published by DEV.bg |
| `salaryCurrency` | null | Salary data not published by DEV.bg |
| `salaryPeriod` | null | Salary data not published by DEV.bg |
> **Note:** DEV.bg does not publish structured salary data. The `salary*` fields are always `null`. Salary information, when mentioned, is embedded in the job description as free text.
### Performance & pricing
| Mode | Speed | Cost |
|------|-------|------|
| API-only (`fetchDetails: false`) | ~17 requests for all 1,600+ jobs | Very low |
| With company details (`fetchDetails: true`) | +1 request per job | Moderate |
**Price: $1.49 per 1,000 results.**
Scraping the full board without detail fetching completes in under a minute. With `fetchDetails: true`, expect approximately 5–10 minutes for a full run.
### Use cases
- **Talent market analysis** — track which tech stacks are most in demand in Bulgaria
- **Competitive intelligence** — monitor which companies are hiring and at what seniority
- **Job aggregators** — power a Bulgarian IT jobs feed with real-time data
- **Salary research** — cross-reference job descriptions for compensation signals
- **Academic research** — map the Bulgarian IT labour market by city, category, and tech
### Scheduled / incremental runs
Enable `skipDuplicates: true` to run this scraper on a schedule and only collect new postings. Jobs are remembered for 90 days across runs.
# Actor input Schema
## `keyword` (type: `string`):
Search keyword to filter jobs by title or description.
## `category` (type: `string`):
Filter by job category slug.
## `seniority` (type: `string`):
Filter by seniority level.
## `location` (type: `string`):
Filter by city. Leave empty for all locations.
## `workMode` (type: `string`):
Filter by work mode. Only applies if no city is selected.
## `postedAfter` (type: `string`):
Return only jobs posted after this date (ISO 8601, e.g. 2025-01-01).
## `fetchDetails` (type: `boolean`):
When enabled, fetches each job detail page to extract company name and company URL. Increases run time and cost proportionally.
## `skipDuplicates` (type: `boolean`):
Skip jobs already collected in previous runs (90-day memory). Useful for incremental/scheduled runs.
## `maxItems` (type: `integer`):
Maximum number of jobs to return. 0 = no limit.
## `startUrls` (type: `array`):
Specific DEV.bg job URLs to scrape. Overrides all filters.
## Actor input object example
```json
{
"keyword": "Python",
"category": "python",
"seniority": "senior",
"location": "sofiya",
"workMode": "fully-remote",
"postedAfter": "2025-01-01",
"fetchDetails": false,
"skipDuplicates": false,
"maxItems": 100,
"startUrls": [
{
"url": "https://dev.bg/company/jobads/egt-digital-java-developer-live-casino/"
}
]
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {};
// Run the Actor and wait for it to finish
const run = await client.actor("unfenced-group/devbg-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {}
# Run the Actor and wait for it to finish
run = client.actor("unfenced-group/devbg-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 '{}' |
apify call unfenced-group/devbg-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=unfenced-group/devbg-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Dev.bg Scraper",
"description": "Extract IT job listings from DEV.bg — Bulgaria's leading tech job board. Filter by category, city, seniority, and work mode.",
"version": "0.0",
"x-build-id": "9yoJ8zugRjpC1T62b"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/unfenced-group~devbg-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-unfenced-group-devbg-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/unfenced-group~devbg-scraper/runs": {
"post": {
"operationId": "runs-sync-unfenced-group-devbg-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/unfenced-group~devbg-scraper/run-sync": {
"post": {
"operationId": "run-sync-unfenced-group-devbg-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"keyword": {
"title": "Keyword",
"type": "string",
"description": "Search keyword to filter jobs by title or description."
},
"category": {
"title": "Job Category",
"enum": [
"",
"net",
"android-development",
"angular",
"automation-qa",
"back-end-development",
"bi-data-visualization",
"big-data",
"c",
"customer-support",
"it-security",
"data-science",
"database-engineer",
"devops",
"erp-crm-development",
"etl-data-warehouse",
"front-end-development",
"full-stack-development",
"go",
"hardware-and-engineering",
"operations",
"ios-development",
"it-business-analyst",
"java",
"javascript",
"machine-learning-ai",
"mobile-development",
"network-engineer",
"php",
"pm-ba-and-more",
"python",
"qa",
"react",
"ruby",
"scala",
"sap",
"system-administration",
"technical-support",
"technical-writing",
"ui-ux-design",
"unity",
"web-development"
],
"type": "string",
"description": "Filter by job category slug."
},
"seniority": {
"title": "Seniority Level",
"enum": [
"",
"intern",
"junior",
"mid-level",
"senior",
"lead"
],
"type": "string",
"description": "Filter by seniority level."
},
"location": {
"title": "City",
"enum": [
"",
"sofiya",
"plovdiv",
"varna",
"burgas",
"ruse",
"stara-zagora",
"kazanluk",
"veliko-turnovo",
"sevlievo",
"blagoevgrad",
"pernik",
"dimitrovgrad"
],
"type": "string",
"description": "Filter by city. Leave empty for all locations."
},
"workMode": {
"title": "Work Mode",
"enum": [
"",
"fully-remote",
"hybrid"
],
"type": "string",
"description": "Filter by work mode. Only applies if no city is selected."
},
"postedAfter": {
"title": "Posted After Date",
"type": "string",
"description": "Return only jobs posted after this date (ISO 8601, e.g. 2025-01-01)."
},
"fetchDetails": {
"title": "Fetch Company Details",
"type": "boolean",
"description": "When enabled, fetches each job detail page to extract company name and company URL. Increases run time and cost proportionally.",
"default": false
},
"skipDuplicates": {
"title": "Skip Duplicates (Cross-run Deduplication)",
"type": "boolean",
"description": "Skip jobs already collected in previous runs (90-day memory). Useful for incremental/scheduled runs.",
"default": false
},
"maxItems": {
"title": "Max Items",
"minimum": 0,
"type": "integer",
"description": "Maximum number of jobs to return. 0 = no limit."
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Specific DEV.bg job URLs to scrape. Overrides all filters.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```