{ "openapi": "3.0.1", "info": { "title": "Tecnoempleo Scraper — 2,400+ Spain IT Jobs, Salaries & Empleo", "description": "Scrape Tecnoempleo.com's full live catalogue — 2,400+ Spanish IT & developer jobs (empleo), far beyond the ~80-item cap of its RSS feed. Get title, company, province, EUR salary, tech stack, date & apply URL. Filter by province, work modality, category & keyword; delta mode for daily alerts.", "version": "0.1", "x-build-id": "jBmG6XUgXjM4HAp90" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nomad-agent~tecnoempleo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nomad-agent-tecnoempleo-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/nomad-agent~tecnoempleo-scraper/runs": { "post": { "operationId": "runs-sync-nomad-agent-tecnoempleo-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/nomad-agent~tecnoempleo-scraper/run-sync": { "post": { "operationId": "run-sync-nomad-agent-tecnoempleo-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": "Optional keyword. Sent to Tecnoempleo's own search (so it narrows the crawl to matching offers) and also applied client-side (case-insensitive) against the title, company, description snippet and technology tags. Leave empty to return all listings." }, "province": { "title": "Province", "type": "string", "description": "Optional Spanish province name to filter by (e.g. 'Madrid', 'Barcelona', 'Valencia', 'Malaga'). Accent- and case-insensitive; resolved live against Tecnoempleo's own province list, so it always matches the site's current options. Unrecognised names are ignored (the run is not filtered by province)." }, "remote": { "title": "Work modality", "enum": [ "any", "remote", "hybrid", "on-site" ], "type": "string", "description": "Filter by work arrangement: 'remote' (100% en remoto), 'hybrid' (híbrido) or 'on-site' (presencial). 'any' (default) returns all.", "default": "any" }, "category": { "title": "Professional category", "type": "string", "description": "Optional professional-function / category name to filter by (e.g. 'Programador', 'Analista', 'DevOps', 'Business Intelligence'). Accent- and case-insensitive; resolved live against Tecnoempleo's own category list. Unrecognised names are ignored." }, "includeDescription": { "title": "Fetch full description + salary", "type": "boolean", "description": "When enabled, fetch each posting's detail page to fill the full job description and structured salary (salaryMin/salaryMax/salaryCurrency/salaryPeriod, in EUR, from the site's own JobPosting data — never guessed). Costs one extra request per returned posting, so it applies after maxItems truncation.", "default": false }, "titleExclude": { "title": "Title must NOT contain", "type": "array", "description": "Skip listings whose title contains any of these case-insensitive terms.", "default": [], "items": { "type": "string" } }, "companyExclude": { "title": "Company must NOT contain", "type": "array", "description": "Skip listings whose company name contains any of these case-insensitive terms.", "default": [], "items": { "type": "string" } }, "postedSince": { "title": "Posted within last N days", "type": "integer", "description": "Only return listings posted within this many days, based on the posting date shown by Tecnoempleo. Listings whose date can't be parsed are always kept (can't be judged, so they're not dropped). Set 0 (default) to disable.", "default": 0 }, "onlyNewSinceLastRun": { "title": "Only new since last run (delta mode)", "type": "boolean", "description": "Incremental mode: remember every listing id returned on previous runs and emit only postings not seen before. Ideal for scheduled runs / daily alerts. State is kept in a named key-value store and persists across runs.", "default": false }, "maxItems": { "title": "Max items", "type": "integer", "description": "Maximum number of postings to return. Thanks to HTML pagination this can go well beyond the RSS feed's ~80-item cap (thousands of listings are available). Set 0 for no limit (bounded only by the total matching offers).", "default": 80 }, "cacheTtlSeconds": { "title": "Cache TTL (seconds)", "type": "integer", "description": "Reuses fetched listing/detail pages for this many seconds so rapid re-runs don't hit Tecnoempleo again. Set 0 to always fetch live.", "default": 1800 } } }, "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 } } } } } } } } } }