# Net-Empregos Scraper (`unfenced-group/net-empregos-scraper`) Actor Scrape 60,000+ job listings from Net-Empregos.com — Portugal's largest job board. Filter by keyword, district, category and job type. No API key required. - **URL**: https://apify.com/unfenced-group/net-empregos-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Jobs, Developer tools, Automation - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 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 ## Net-Empregos Scraper Collect job listings from [Net-Empregos.com](https://www.net-empregos.com) — Portugal's largest job board with 60,000+ active vacancies across all industries and regions. No API key required. Supports keyword search, district, category, and job type filters. ![Net-Empregos Scraper](https://i.imgur.com/shz6Bkr.png) --- ### Why use this scraper? - **Full coverage** — access all 60,000+ active listings across Portugal and Portuguese-speaking countries abroad - **Flexible filtering** — combine keyword, district, category, and job type to target exactly the roles you need - **Optional descriptions** — choose between fast list-only mode or full description extraction per job - **Repost detection** — 90-day deduplication memory prevents the same vacancy from appearing twice across runs - **Bulk-ready** — collect up to 100,000 results per run at $1.50 per 1,000 results --- ### Input parameters | Parameter | Type | Default | Description | |---|---|---|---| | `keyword` | string | _(empty)_ | Search terms, e.g. `motorista pesados` or `enfermeiro` | | `zone` | integer | `0` | District filter. `0` = all zones (see table below) | | `category` | integer | `0` | Category filter. `0` = all categories (see table below) | | `jobType` | integer | `0` | `0`=All, `1`=Full-time, `2`=Part-time, `3`=Internship, `4`=Remote | | `city` | string | _(empty)_ | City name filter, e.g. `Covilha`, `Braga` | | `maxResults` | integer | `100` | Maximum number of listings to return | | `fetchDetails` | boolean | `false` | Fetch full job descriptions (slower, higher cost) | | `daysOld` | integer | `0` | Only return jobs posted within N days. `0` = disabled | | `skipReposts` | boolean | `false` | Skip jobs already seen in previous runs | | `startUrls` | array | _(empty)_ | Scrape specific job URLs directly | #### Zone IDs | Zone | ID | Zone | ID | |---|---|---|---| | Lisboa | 1 | Porto | 2 | | Braga | 3 | Aveiro | 4 | | Bragança | 5 | Vila Real | 6 | | Guarda | 7 | Viseu | 8 | | Coimbra | 9 | Castelo Branco | 10 | | Leiria | 11 | Santarém | 12 | | Setúbal | 13 | Évora | 14 | | Beja | 15 | Portalegre | 16 | | Faro | 17 | Açores | 25 | | Madeira | 26 | Viana do Castelo | 28 | | Foreign (all) | 29 | | | #### Category IDs | Category | ID | Category | ID | |---|---|---|---| | Administração / Secretariado | 29 | Agricultura / Florestas | 39 | | Arquitectura / Design | 22 | Banca / Seguros | 16 | | Beleza / Moda | 47 | Call Center / Help Desk | 57 | | Comercial / Vendas | 53 | Construção Civil | 23 | | Contabilidade / Finanças | 15 | Desporto | 28 | | Direito / Justiça | 44 | Educação / Formação | 11 | | Engenharia (Civil) | 45 | Farmácia / Biotecnologia | 41 | | Gestão de Empresas | 26 | Gestão RH | 32 | | Hotelaria / Turismo | 9 | Imobiliário | 12 | | Indústria / Produção | 6 | Informática (Programação) | 5 | | Limpezas / Domésticas | 58 | Lojas / Comércio | 30 | | Publicidade / Marketing | 19 | Restauração / Bares | 42 | | Saúde / Medicina | 14 | Serviços Sociais | 55 | | Telecomunicações | 1 | Transportes / Logística | 43 | --- ### Output Each result contains the following fields: | Field | Type | Description | |---|---|---| | `jobId` | string | Unique job identifier from the site | | `title` | string | Job title | | `url` | string | Direct URL to the job listing | | `publishDate` | string | Publication date as displayed, e.g. `5-4-2026` | | `publishDateISO` | string | Publication date in ISO 8601 format, e.g. `2026-04-05` | | `location` | string | District / region | | `category` | string | Job category | | `company` | string | Hiring company name | | `companyId` | string | Internal company ID | | `companyLogoUrl` | string | Company logo URL (if available) | | `isFeatured` | boolean | Whether the listing is a featured/promoted vacancy | | `description` | string | Full job description HTML (only with `fetchDetails: true`) | | `descriptionText` | string | Full job description plain text (only with `fetchDetails: true`) | | `source` | string | Always `net-empregos.com` | | `contentHash` | string | MD5 hash of title + company + date for deduplication | | `scrapedAt` | string | ISO 8601 timestamp of when the record was scraped | #### Example output ```json { "jobId": "15244888", "title": "Assistente administrativo/a", "url": "https://www.net-empregos.com/15244888/assistente-administrativo-a/", "publishDate": "5-4-2026", "publishDateISO": "2026-04-05", "location": "Lisboa", "category": "Administração / Secretariado", "company": "COSTUMES POMPOSOS LDA", "companyId": "297987", "companyLogoUrl": null, "isFeatured": true, "description": null, "descriptionText": null, "source": "net-empregos.com", "contentHash": "a3f8b91c2d44", "scrapedAt": "2026-04-05T07:12:34.000Z" } ```` *** ### Performance | Mode | Speed | Cost per 1,000 results | |---|---|---| | List only (`fetchDetails: false`) | ~500–800 results/min | $1.50 | | With descriptions (`fetchDetails: true`) | ~40–60 results/min | $1.50 + higher proxy cost | | Full dataset (60,000 listings) | ~2–4 hours | ~$90 | *** ### Pricing **$1.50 per 1,000 results.** Flat-rate competitors charge $30–$99/month regardless of volume. This actor costs exactly what you use. | Volume | Cost | |---|---| | 1,000 results | $1.50 | | 10,000 results | $15.00 | | 50,000 results | $75.00 | | 100,000 results | $150.00 | *** ### Known limitations - Job contact email addresses are hidden behind a login modal and cannot be extracted without credentials. - No salary data is available on Net-Empregos listing pages. - Listings marked "anónimo" or "Confidencial" will not have a company name. *** ### Technical details Built and maintained by [unfenced-group](https://apify.com/unfenced-group). Runs on RESIDENTIAL proxies from Portugal for reliable access. No authentication or API credentials required to use this actor. *** ### Additional services Need a custom scraper, scheduled data delivery, or help integrating this data into your pipeline? Contact us at **info@unfencedgroup.nl** — we build and maintain custom data solutions on Apify. *** *unfenced-group · [Apify Store](https://apify.com/unfenced-group) · info@unfencedgroup.nl* # Actor input Schema ## `keyword` (type: `string`): Search keyword(s). Use spaces to combine terms, e.g. 'motorista pesados' or 'enfermeiro'. ## `zone` (type: `integer`): Filter by Portuguese district. 0 = all zones. Common values: 1=Lisboa, 2=Porto, 3=Braga, 4=Aveiro, 7=Guarda, 8=Viseu, 9=Coimbra, 11=Leiria, 12=Santarém, 13=Setúbal, 14=Évora, 17=Faro, 25=Açores, 26=Madeira. ## `category` (type: `integer`): Filter by job category. 0 = all categories. Common values: 1=Telecomunicações, 5=Informática (Programação), 6=Indústria/Produção, 9=Hotelaria/Turismo, 11=Educação/Formação, 14=Saúde/Medicina, 15=Contabilidade/Finanças, 22=Arquitectura/Design, 23=Construção Civil, 26=Gestão de Empresas, 29=Administração/Secretariado, 30=Lojas/Comércio, 39=Agricultura, 42=Restauração, 43=Transportes/Logística, 53=Comercial/Vendas, 57=Call Center, 58=Limpezas. ## `jobType` (type: `integer`): Filter by schedule type. 0=All, 1=Tempo Inteiro (full-time), 2=Part-Time, 3=Estágio (internship), 4=Teletrabalho (remote). ## `city` (type: `string`): Filter by city name, e.g. 'Lisboa', 'Covilha', 'Braga'. Leave empty to use zone filter only. ## `maxResults` (type: `integer`): Maximum number of job listings to return. ## `fetchDetails` (type: `boolean`): When enabled, fetches the full job description for each listing. Increases run time and cost. Recommended only when description text is required. ## `daysOld` (type: `integer`): Only return jobs published within the last N days. Set to 0 to disable. ## `skipReposts` (type: `boolean`): Skip jobs that have already been collected in a previous run (90-day memory). ## `startUrls` (type: `array`): Fetch specific job detail pages directly. Bypasses search and pagination. Each item should be a full URL, e.g. https://www.net-empregos.com/15244888/assistente-administrativo/ ## Actor input object example ```json { "keyword": "", "zone": 0, "category": 0, "jobType": 0, "city": "", "maxResults": 100, "fetchDetails": false, "daysOld": 0, "skipReposts": false, "startUrls": [] } ``` # 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/net-empregos-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/net-empregos-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/net-empregos-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/net-empregos-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Net-Empregos Scraper", "description": "Scrape 60,000+ job listings from Net-Empregos.com — Portugal's largest job board. Filter by keyword, district, category and job type. No API key required.", "version": "0.0", "x-build-id": "qRairdsPWdNluksC8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~net-empregos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-net-empregos-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~net-empregos-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-net-empregos-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~net-empregos-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-net-empregos-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(s). Use spaces to combine terms, e.g. 'motorista pesados' or 'enfermeiro'.", "default": "" }, "zone": { "title": "Zone (district)", "minimum": 0, "type": "integer", "description": "Filter by Portuguese district. 0 = all zones. Common values: 1=Lisboa, 2=Porto, 3=Braga, 4=Aveiro, 7=Guarda, 8=Viseu, 9=Coimbra, 11=Leiria, 12=Santarém, 13=Setúbal, 14=Évora, 17=Faro, 25=Açores, 26=Madeira.", "default": 0 }, "category": { "title": "Category", "minimum": 0, "type": "integer", "description": "Filter by job category. 0 = all categories. Common values: 1=Telecomunicações, 5=Informática (Programação), 6=Indústria/Produção, 9=Hotelaria/Turismo, 11=Educação/Formação, 14=Saúde/Medicina, 15=Contabilidade/Finanças, 22=Arquitectura/Design, 23=Construção Civil, 26=Gestão de Empresas, 29=Administração/Secretariado, 30=Lojas/Comércio, 39=Agricultura, 42=Restauração, 43=Transportes/Logística, 53=Comercial/Vendas, 57=Call Center, 58=Limpezas.", "default": 0 }, "jobType": { "title": "Job type", "minimum": 0, "maximum": 4, "type": "integer", "description": "Filter by schedule type. 0=All, 1=Tempo Inteiro (full-time), 2=Part-Time, 3=Estágio (internship), 4=Teletrabalho (remote).", "default": 0 }, "city": { "title": "City", "type": "string", "description": "Filter by city name, e.g. 'Lisboa', 'Covilha', 'Braga'. Leave empty to use zone filter only.", "default": "" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of job listings to return.", "default": 100 }, "fetchDetails": { "title": "Fetch job descriptions", "type": "boolean", "description": "When enabled, fetches the full job description for each listing. Increases run time and cost. Recommended only when description text is required.", "default": false }, "daysOld": { "title": "Max age (days)", "minimum": 0, "type": "integer", "description": "Only return jobs published within the last N days. Set to 0 to disable.", "default": 0 }, "skipReposts": { "title": "Skip already-seen jobs", "type": "boolean", "description": "Skip jobs that have already been collected in a previous run (90-day memory).", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Fetch specific job detail pages directly. Bypasses search and pagination. Each item should be a full URL, e.g. https://www.net-empregos.com/15244888/assistente-administrativo/", "default": [], "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 } } } } } } } } } } ```