theprotocol.it Jobs Scraper

Scrape theprotocol.it jobs from theprotocol.it, a Polish IT job board, and get clean data as JSON, CSV or Excel: salaries (also per month), required and optional skills, seniority, contract types, locations and company. No browser, no login: it reads the data theprotocol.it's own pages carry, and you can run it from the Apify API too.

🔎 What does theprotocol.it Jobs Scraper do?

• Searches theprotocol.it by keywords, cities, categories, work type, experience level, contract type and "with salary only", or reads any listing or offer URL you paste.
• Returns one row per offer. With extractFullDetails on, each offer's own page is read too: full description (text and HTML), skills, benefits, address and company text.

⭐ Why this one

1️⃣ One schema across job portals. All our job actors share one output schema and one input schema. Build your pipeline once: our other job actors (NoFluffJobs, Pracuj.pl, Just Join IT, RocketJobs.pl, Bulldogjob, BlueLionJob, Skillshot.pl, Hollylist) take the same input and return the same fields, so adding a portal means changing the actor name, not your code.

• Low price, no start fee. $0.40 per 1,000 offers. The one other theprotocol.it scraper on the Store charges $1.00 per 1,000 rows plus a start fee of $0.0001 per run. You pay only for rows you get.
• Salaries per month, plus the employer's own figures. Each pay range starts with a monthly entry; a pay per hour also keeps the employer's own figures as a second entry (isOriginal true). Each entry has min, max, currency, period, contractType and grossNet.
• Skills with a must-have flag. Every skill says whether the offer requires it or lists it as optional.
• Filters buyers ask for: search words, locations, categories, work type, experience level, contract type and "with salary only". Or paste any theprotocol.it listing or offer URL.
• Company data: with details on, each row carries the employer's active offers count and its own text about itself, once per company per run.
• Honest runs: a run summary and a health status. A search that fails writes an unbilled diagnostic row.

🚀 How to scrape theprotocol.it jobs

1. Open the actor on Apify and click Try for free.
2. Fill in keywords, cities and filters, or paste a theprotocol.it listing or offer URL into startUrls.
3. Click Start.
4. Download the theprotocol.it jobs data as JSON, CSV or Excel from the Output tab, or fetch it with the Apify API.

Data

This actor returns only what the site shows publicly at run time. We don't store or keep that data and are not its controller — you decide how you use it.

This is an independent tool, not affiliated with or endorsed by theprotocol.it; trademarks belong to their owners. It reads only public job pages: no login, no recruiter accounts. You are responsible for following theprotocol.it's terms and data-protection law (GDPR and others).

🤖 Use with AI agents (MCP)

AI assistants (Claude, ChatGPT, Cursor…) can run this actor through Apify's MCP server. Connect the server in your assistant, then ask, for example:

Use the theprotocol.it Jobs Scraper to find senior Python offers in Warsaw or fully remote that show a salary. Show the 10 best-paid, with company, salary, period and link.

🔌 Run it your way

• Schedule it with Apify schedules for daily new-job feeds.
• Call it from the Apify API and its clients (Python, JavaScript).
• Connect it to Make, n8n, Zapier, webhooks or Google Sheets.
• Ask an AI agent to run it: see Use with AI agents (MCP).

⚙️ Input

Every job actor of ours takes the same inputs. Example: Python offers in Warsaw, B2B or employment, remote or hybrid, mid or senior, with full details:

{
  "searchQueries": ["python"],
  "locations": ["Warszawa"],
  "contractTypes": ["b2b", "employment"],
  "workType": ["remote", "hybrid"],
  "experience": ["mid", "senior"],
  "maxResults": 50,
  "extractFullDetails": true
}

Field	Default	Notes
maxResults	50	Offers in total. 0 = no limit (the run timeout still applies). theprotocol.it lists 50 offers per page
startUrls	–	theprotocol.it listing pages (https://theprotocol.it/praca, https://theprotocol.it/filtry/senior;p/zdalna;rw) or offer pages (https://theprotocol.it/praca/<slug>,oferta,<id>; /szczegoly/praca/... works too). A listing URL is read as that listing, newest first from page 1; an offer URL is always read from its own page. The filters below still apply to the rows
searchQueries	–	Keywords, one search per line (a technology or a job title). Empty: every offer. theprotocol.it searches the whole offer text
locations	–	City names; accents and case do not matter (Krakow = Kraków = KRAKÓW). Any Polish city works; a city search also returns remote offers, as the site does. Empty: anywhere
categories	–	backend, frontend, fullstack, mobile, devops, data, ai-ml, testing, security, it-admin, support, embedded, gamedev, erp, architecture, project-management, product, ux-ui, business-analysis
contractTypes	–	employment, b2b, mandate, specific-task, internship
workType	–	remote, hybrid, onsite
experience	–	intern, junior, mid, senior, expert, lead, manager, executive
withSalaryOnly	false	Only offers that show a salary
extractFullDetails	false	Off: listing-level rows, cheaper and faster. On: each offer's own page (and its company, once per run) is read for the description, skills, benefits and company details. An offer URL is always read in full
maxConcurrency	1	Searches and detail pages processed in parallel
maxRequestsPerMinute	60	Request rate for the whole run
proxyConfiguration	Apify Proxy	Apify Proxy settings; the actor uses Apify Proxy unless you give your own proxy URLs
maxRequestRetries	2	Retries after a failed request

theprotocol.it lists 50 offers per page; narrow a run with locations, categories or filters.

🧭 Input modes: what you give, what you get

One actor, six ways to use it. The mode follows from what you fill in.

Mode	You give	Rows	Offer pages read
🟢 1. Default search	nothing (empty input)	Newest offers, up to maxResults	Only with extractFullDetails on
🔤 2. Keyword search	searchQueries	One search per keyword	Only with extractFullDetails on
🎛️ 3. Filtered search	one or more filters, keywords optional	Offers matching the filters	Only with extractFullDetails on
🔗 4. Listing / search URL	startUrls with a listing URL	That listing, as the site shows it	Only with extractFullDetails on
📄 5. One offer URL	startUrls with an offer URL	That one offer	Always (a full row either way)
🧩 6. URLs + filters	startUrls plus filters	Only rows matching the filters	Offer URLs always; listed offers only with extractFullDetails on

Minimal input for each mode, as in our test runs (there with "extractFullDetails": true). Add it to any of them for full rows.

🟢 1. Default search

{"maxResults": 3}

🔤 2. Keyword search

{"searchQueries": ["python"], "maxResults": 3}

🎛️ 3. Filtered search

{"searchQueries": ["python"], "locations": ["Warszawa"], "contractTypes": ["b2b", "employment"], "workType": ["remote", "hybrid"], "experience": ["senior"], "maxResults": 3}

🔗 4. Listing / search URL

{"startUrls": [{"url": "https://theprotocol.it/praca?kw=ai+devops"}], "maxResults": 3}

📄 5. One offer URL

{"startUrls": [{"url": "https://theprotocol.it/szczegoly/praca/senior-ai-devops-engineer-warszawa,oferta,01000000-326a-b7bb-0cf8-08df13fcc123"}], "maxResults": 3}

🧩 6. URLs + filters

{"startUrls": [{"url": "https://theprotocol.it/praca?kw=ai+devops"}, {"url": "https://theprotocol.it/szczegoly/praca/senior-ai-devops-engineer-warszawa,oferta,01000000-326a-b7bb-0cf8-08df13fcc123"}], "locations": ["Warszawa"], "contractTypes": ["b2b"], "workType": ["remote"], "experience": ["senior"], "withSalaryOnly": true, "maxResults": 3}

Turn on extractFullDetails to apply your filters to every offer's own page.

📦 Output: theprotocol.it jobs data

A real row from a keyword search with details on (shortened; empty fields left out):

{
  "recordType": "job",
  "source": "theprotocol",
  "url": "https://theprotocol.it/szczegoly/praca/senior-python-developer-warszawa,oferta,01000000-af85-32bc-1c9b-08df25d4aa13",
  "title": "Senior Python Developer",
  "company": {
    "name": "ASTEK Polska",
    "profileUrl": "https://theprotocol.it/praca?kw=astek+polska",
    "activeOffersCount": 51
  },
  "locations": [{"city": "Warszawa", "region": "mazowieckie", "countryCode": "PL"}],
  "workType": [{"type": "hybrid"}],
  "categories": [{"value": "backend", "original": "Backend"}],
  "experience": {"levels": [{"value": "senior", "original": "senior", "minYears": 3}]},
  "contractTypes": [{"value": "employment", "original": "umowa o pracę"}, {"value": "b2b", "original": "kontrakt B2B"}],
  "workTime": "full-time",
  "salaries": [
    {"contractType": "employment", "currency": "PLN", "grossNet": "gross", "min": 16000, "max": 18000, "period": "month", "isOriginal": true},
    {"contractType": "b2b", "currency": "PLN", "grossNet": "net", "min": 20160, "max": 25200, "period": "month", "isOriginal": false},
    {"contractType": "b2b", "currency": "PLN", "grossNet": "net", "min": 120, "max": 150, "period": "hour", "isOriginal": true}
  ],
  "skills": [
    {"name": "Python", "required": true, "source": "portal"},
    {"name": "FastAPI", "required": true, "source": "portal"},
    {"name": "Django", "required": true, "source": "portal"}
  ],
  "benefits": ["Pakiet benefitów pracowniczych"],
  "languages": {"offer": "pl"},
  "description": {"text": "…", "html": "…"},
  "dates": {"posted": "2026-10-09", "expires": "2026-11-08", "scraped": "2026-10-09T07:18:46Z"},
  "extensions": {"isQuickApply": true, "openToUkrainians": false}
}

Missing data is null, never a guess.

Run status. After each run, open the run's key-value store (Storage tab) to see how it went:

• RUN_HEALTH: ok, or degraded with the reason (no rows, a failed request, a warning, or a row that broke a data rule).
• RUN_SUMMARY: the run's numbers: rows, requests, retries, failed requests, warnings and billed events.

💰 Pricing (Pay-Per-Event)

Event	Price	Trigger
Result row (job-scraped)	$0.0004 (= $0.40 / 1,000)	Per offer returned
Details row (job-details-scraped)	+$0.0015 (= +$1.50 / 1,000)	Per offer whose own page was read (extractFullDetails on, or an offer URL)

No start fee: a run costs only the rows it returns. Diagnostic rows are never billed. Example: 1,000 offers with details = $0.40 + $1.50 = $1.90.

Free plan: each run returns up to 1,000 offers, with full details; upgrade your Apify plan for more.

🎯 Use cases

• Track new IT openings for a role or stack on a daily schedule.
• Feed a job board aggregator or a personal job-search dashboard.
• Compare pay by contract type, city and experience level, in the employers' own currencies.
• Market research: which skills and seniority levels are in demand.
• Lead lists of hiring companies.
• Run the same pipeline over several Polish job portals, since they share one schema.

🩺 If a run fails

The run health (the RUN_HEALTH record, RUN_SUMMARY and the last line of the log) names the cause, for example site down: list request answered 500 x3. Find that start of the message in the table.

Error in the log / run health	What it means	What you do
site down: <request> answered 500, 502-504, 520-526	The site is offline or has a fault. The actor waits longer between tries, then stops the run.	Try again later.
blocked: <request> answered 401, 403, 1020 or a captcha page	The site refused the request or showed a captcha page.	The actor already retries once through the Apify proxy. If it still fails, turn on the Apify proxy in the input (use the RESIDENTIAL group if it is already on).
rate limited: <request> answered 429	The site asks for fewer requests. The actor waits and slows down by itself.	If it keeps happening, lower maxRequestsPerMinute.
gone: <request> answered 404, 410	The page or offer was removed. The actor skips it and it is not charged.	Nothing; this is normal.
network error: <request> failed with timeout (or connection error, DNS error)	A timeout or a broken connection. The actor retries with a pause.	Try again later.
wrong answer: <request> returned HTML instead of JSON (or an empty body)	The site answered with a page that is not data (HTML instead of JSON, an empty body). The site has probably changed.	Report it in the Issues tab; we fix it.

❓ FAQ

How many offers can I get?

As many as maxResults says (0 = no limit). theprotocol.it lists 50 offers per page; narrow a run by city, category or experience.

How do I export theprotocol.it jobs to Excel or CSV?

Run the actor, open the Output tab and pick Excel or CSV in the export options. JSON, XML and HTML are there too, and the Apify API returns the same data.

How do I get theprotocol.it salary data?

Every offer row has a salaries list with min, max, currency, period, contractType and grossNet. Turn on withSalaryOnly to get only offers that show pay.

What is the monthly salary?

Each pay range starts with a monthly item (period "month"). If the employer gives pay per hour, we compute it: hour × 168, rounded to a whole unit. The employer's own figures follow it with isOriginal true.

Can I combine it with other portals?

Yes. All our job actors share one output schema and one input schema, so rows from different portals fit one table. See the list below.

🔗 Other Polish job scrapers (same schema)

• NoFluffJobs Jobs Scraper
• Just Join IT Jobs Scraper
• Pracuj.pl Jobs Scraper
• Bulldogjob Jobs Scraper
• RocketJobs.pl Jobs Scraper
• BlueLionJob Jobs Scraper
• Aplikuj.pl Jobs Scraper
• Inhire.io Jobs Scraper
• Skillshot.pl Jobs Scraper (video-game jobs)
• Hollylist Jobs Scraper (US entertainment jobs)

💬 Feedback and custom work

Need another portal, a field or a custom feed? Open an issue on the Issues tab.