# InfoJobs Spain Extractor (`kawsar/infojobs-spain-extractor`) Actor Pulls job listings from InfoJobs.net by keyword, location, and category, so you can track Spanish salary ranges and hiring trends without manual browsing. - **URL**: https://apify.com/kawsar/infojobs-spain-extractor.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 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/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 ## InfoJobs Spain Extractor Extract job listings from [InfoJobs.net](https://www.infojobs.net), Spain's largest job board, and get clean structured data in seconds. Search across multiple keywords and locations in a single run. No coding or browser automation needed. Each result includes the job title, company, city, salary range, contract type, work schedule, teleworking mode, full description, and publication date. All data comes directly from InfoJobs search pages — no individual job page visits required. --- ### Features - **Multiple keywords** — run one or many search terms in a single actor run - **Multiple locations** — search across Madrid, Barcelona, Valencia, and any other Spanish city at once - **Cartesian product search** — each keyword is searched in every location you specify - **Automatic deduplication** — the same job listing is never returned twice, even if it appears in multiple searches - **Category and contract type filters** — narrow results by job category or contract type - **22 jobs per search page** — all listings extracted from InfoJobs, not just the 5 featured ones - **Salary as numbers** — `salaryMin` and `salaryMax` are integers ready for analysis, not just display text - **ISO 8601 dates** — `postedDate` is a proper timestamp, not a relative string like "Hace 2d" - **Teleworking mode** — know whether a job is Híbrido, Solo teletrabajo, or Presencial --- ### Output fields | Field | Type | Description | Example | |-------|------|-------------|---------| | `jobTitle` | string | Job title | `Desarrollador Python Senior` | | `company` | string | Hiring company name | `Tech Solutions SL` | | `location` | string | City | `Madrid` | | `salary` | string | Salary range text | `30.000 - 45.000 EUR Bruto/año` | | `salaryMin` | integer | Minimum salary (EUR/year) | `30000` | | `salaryMax` | integer | Maximum salary (EUR/year) | `45000` | | `contractType` | string | Contract type | `Contrato indefinido` | | `workday` | string | Work schedule | `Jornada completa` | | `teleworking` | string | Work modality | `Híbrido` | | `jobDescription` | string | Full job description text | `Buscamos un Desarrollador...` | | `postedDate` | string | Publication date (ISO 8601) | `2026-05-22T08:57:00Z` | | `url` | string | Link to the job listing | `https://www.infojobs.net/...` | | `jobId` | string | InfoJobs internal offer ID | `1d188ed1ab43e68a` | | `remote` | boolean | True if Híbrido or Solo teletrabajo | `true` | | `urgent` | boolean | Marked as urgent | `false` | | `scrapedAt` | string | Extraction timestamp (UTC) | `2026-05-23T11:30:00+00:00` | | `error` | string | Error message if fetch failed | `null` | --- ### Input parameters #### Search | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `keywords` | string list | Yes | — | One or more search terms (e.g. `python`, `data scientist`) | | `location` | string list | No | All Spain | One or more cities or provinces (e.g. `Madrid`, `Barcelona`) | #### Filters | Parameter | Type | Required | Default | Options | |-----------|------|----------|---------|---------| | `category` | select | No | All | See category list below | | `contractType` | select | No | Any | Permanent, Temporary, Internship, Freelance | | `includeDescription` | boolean | No | `true` | Include full description text in output | #### Limits | Parameter | Type | Default | Range | |-----------|------|---------|-------| | `maxItems` | integer | `20` | 1 – 500 | | `requestTimeoutSecs` | integer | `30` | 5 – 120 | --- ### Example inputs #### Single keyword, single city ```json { "keywords": ["programador python"], "location": ["Madrid"], "maxItems": 50 } ```` #### Multiple keywords across multiple cities ```json { "keywords": ["data scientist", "machine learning engineer", "python developer"], "location": ["Madrid", "Barcelona", "Valencia"], "contractType": "indefinido", "maxItems": 200 } ``` This runs 9 searches (3 keywords × 3 cities) and returns up to 200 results per combination — up to 1,800 total unique results. #### All Spain, IT category only ```json { "keywords": ["fullstack developer"], "category": "informatica-telecomunicaciones", "includeDescription": false, "maxItems": 100 } ``` Set `includeDescription: false` for faster runs when you only need metadata. #### Salary benchmarking scan ```json { "keywords": ["java developer", "python developer", "frontend developer", "devops", "data engineer"], "location": ["Madrid", "Barcelona"], "contractType": "indefinido", "maxItems": 500 } ``` *** ### Example output record ```json { "jobTitle": "Desarrollador Python Senior", "company": "Tech Solutions SL", "location": "Madrid", "salary": "30.000 - 45.000 EUR Bruto/año", "salaryMin": 30000, "salaryMax": 45000, "contractType": "Contrato indefinido", "workday": "Jornada completa", "teleworking": "Híbrido", "jobDescription": "Buscamos un Desarrollador Python con experiencia en Django y REST APIs...", "postedDate": "2026-05-22T08:57:00Z", "url": "https://www.infojobs.net/madrid/desarrollador-python-senior/of-i1d188ed1ab43e68a", "jobId": "1d188ed1ab43e68a3dff7af0a82da2", "remote": true, "urgent": false, "scrapedAt": "2026-05-23T11:30:00+00:00", "error": null } ``` *** ### Job categories Use these values in the `category` filter: | Value | Category | |-------|----------| | `informatica-telecomunicaciones` | IT and Telecommunications | | `marketing-publicidad-comunicacion` | Marketing, Advertising and Communication | | `administracion-empresas` | Business Administration | | `comercial-ventas` | Sales and Commercial | | `recursos-humanos` | Human Resources | | `contabilidad-finanzas-banca` | Accounting, Finance and Banking | | `ingenieria-produccion-industrial` | Engineering and Industrial Production | | `atencion-clientes-call-center` | Customer Service and Call Center | | `diseno-artes-graficas` | Design and Graphic Arts | | `educacion-formacion` | Education and Training | | `hosteleria-turismo` | Hospitality and Tourism | | `legal-asesorias` | Legal and Advisory | | `logistica-transporte-trafico` | Logistics and Transport | | `sanidad-salud` | Healthcare | | `inmobiliario-construccion` | Real Estate and Construction | *** ### Use cases **Salary benchmarking across Spain** Run multiple role keywords across Madrid, Barcelona, and other major cities to build a salary dataset segmented by location. Use `salaryMin` and `salaryMax` for instant numeric analysis. **Hiring trend tracking** Search for specific technologies or skills weekly and compare how many job listings appear. Track whether demand for a skill is growing or shrinking in Spain's job market. **Competitor intelligence** Search for your company's industry or your competitors' names to see what roles they are actively hiring for, what salaries they offer, and how many open positions exist. **Talent pipeline building** Collect listings across multiple cities and categories in a single run, deduplicated automatically, to feed a recruitment intelligence dashboard. **Remote work analysis** Filter by `remote: true` in your downstream analysis to see which companies and roles offer Híbrido or Solo teletrabajo in Spain's current market. **Job alert system** Run the actor on a schedule to detect new listings for a specific keyword and location, then compare with previous results to surface only new postings. *** ### How it works The actor fetches InfoJobs search result pages and reads the structured job data embedded directly in the page HTML by InfoJobs's servers. This approach returns all 22 listings per page reliably, including salary as numeric ranges, ISO dates, and teleworking mode. No individual job page visits are required unless disabled. Each page fetch goes through built-in bypass infrastructure to handle access controls. The actor paginates automatically until `maxItems` is reached or InfoJobs returns no more results. When multiple keywords and locations are provided, the actor runs each combination in sequence and deduplicates results by job ID so the same listing never appears twice. *** ### Tips - Leave `location` empty to search across all of Spain. Add specific cities to get province-level data. - `maxItems` is **per keyword+location combination**. With 3 keywords × 2 locations and `maxItems=20`, the actor runs 6 searches and returns up to 120 total unique results. - Turn off `includeDescription` to get faster, lighter output when you only need metadata. - InfoJobs returns up to 22 listings per page. The actor fetches as many pages as needed to reach `maxItems`. - `postedDate` is an ISO 8601 UTC timestamp — easy to parse and sort in any tool. - `salaryMin` and `salaryMax` are `null` when the employer has not disclosed the salary. About 40–50% of Spanish listings omit salary. *** ### Limitations - Maximum 500 results per run. - Salary data reflects what employers choose to disclose on InfoJobs. Many listings do not publish salary ranges. - Fields like experience required, education level, and application count are not available in InfoJobs search results and are not returned. - InfoJobs content is in Spanish. # Actor input Schema ## `keywords` (type: `array`): One or more job search terms. Each keyword runs a separate search and results are combined. Example: 'programador python', 'data scientist', 'fullstack developer'. ## `location` (type: `array`): One or more cities or provinces to search in. Leave empty to search across all of Spain. Each location is combined with every keyword. Example: 'Madrid', 'Barcelona', 'Valencia'. ## `category` (type: `string`): Filter results by job category. ## `contractType` (type: `string`): Filter by employment contract type. ## `includeDescription` (type: `boolean`): Include the full job description text in results. Disable to get lighter metadata-only output. ## `maxItems` (type: `integer`): Maximum number of job listings to collect per keyword+location combination. For example, 3 keywords × 2 locations with maxItems=20 returns up to 120 total results (20 per search). ## `requestTimeoutSecs` (type: `integer`): Per-request timeout in seconds. ## Actor input object example ```json { "keywords": [ "programador python", "data scientist" ], "location": [ "Madrid", "Barcelona" ], "category": "", "contractType": "", "includeDescription": true, "maxItems": 20, "requestTimeoutSecs": 30 } ``` # 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 = { "keywords": [ "programador python" ] }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/infojobs-spain-extractor").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 = { "keywords": ["programador python"] } # Run the Actor and wait for it to finish run = client.actor("kawsar/infojobs-spain-extractor").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 '{ "keywords": [ "programador python" ] }' | apify call kawsar/infojobs-spain-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/infojobs-spain-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "InfoJobs Spain Extractor", "description": "Pulls job listings from InfoJobs.net by keyword, location, and category, so you can track Spanish salary ranges and hiring trends without manual browsing.", "version": "0.0", "x-build-id": "dXcVeFpyFV9JgIDPK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~infojobs-spain-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-infojobs-spain-extractor", "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/kawsar~infojobs-spain-extractor/runs": { "post": { "operationId": "runs-sync-kawsar-infojobs-spain-extractor", "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/kawsar~infojobs-spain-extractor/run-sync": { "post": { "operationId": "run-sync-kawsar-infojobs-spain-extractor", "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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Search keywords", "type": "array", "description": "One or more job search terms. Each keyword runs a separate search and results are combined. Example: 'programador python', 'data scientist', 'fullstack developer'.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "array", "description": "One or more cities or provinces to search in. Leave empty to search across all of Spain. Each location is combined with every keyword. Example: 'Madrid', 'Barcelona', 'Valencia'.", "items": { "type": "string" } }, "category": { "title": "Job category", "enum": [ "", "informatica-telecomunicaciones", "marketing-publicidad-comunicacion", "administracion-empresas", "comercial-ventas", "recursos-humanos", "contabilidad-finanzas-banca", "ingenieria-produccion-industrial", "atencion-clientes-call-center", "diseno-artes-graficas", "educacion-formacion", "hosteleria-turismo", "legal-asesorias", "logistica-transporte-trafico", "sanidad-salud", "inmobiliario-construccion" ], "type": "string", "description": "Filter results by job category.", "default": "" }, "contractType": { "title": "Contract type", "enum": [ "", "indefinido", "temporal", "practicas", "autonomo" ], "type": "string", "description": "Filter by employment contract type.", "default": "" }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Include the full job description text in results. Disable to get lighter metadata-only output.", "default": true }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of job listings to collect per keyword+location combination. For example, 3 keywords × 2 locations with maxItems=20 returns up to 120 total results (20 per search).", "default": 20 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout in seconds.", "default": 30 } } }, "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 } } } } } } } } } } ```