{
"openapi": "3.0.1",
"info": {
"title": "InfoJobs Scraper — Ofertas de Trabajo y Empleo España",
"description": "Scrape ofertas de trabajo y empleo from InfoJobs.net, Spain's largest job board. Keyword, province, contract, jornada and teletrabajo filters; AI skill tags, structured salary (min/max), postedAt and apply URL. Delta mode for alert bots. For recruiters, job boards and Spanish market analysis.",
"version": "0.1",
"x-build-id": "3qynbueQEPd3W0tnP"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/nomad-agent~infojobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-nomad-agent-infojobs-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~infojobs-scraper/runs": {
"post": {
"operationId": "runs-sync-nomad-agent-infojobs-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~infojobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-nomad-agent-infojobs-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": "Free-text search query (e.g. data engineer, marketing). Leave empty to return the latest postings across all categories."
},
"province": {
"title": "Province",
"enum": [
"",
"28",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"29",
"20",
"30",
"31",
"32",
"33",
"34",
"35",
"36",
"37",
"38",
"39",
"40",
"41",
"46",
"42",
"43",
"44",
"45",
"47",
"48",
"49",
"50",
"51",
"52",
"53"
],
"type": "string",
"description": "Restrict results to a single Spanish province. Leave as All provinces to search nationwide.",
"default": ""
},
"teleworking": {
"title": "Teletrabajo / work mode",
"type": "string",
"description": "Keep only listings whose work-mode label matches (accent- and case-insensitive substring). Values shown on InfoJobs cards: Presencial (on-site), Híbrido (hybrid), Teletrabajo (remote). Leave empty for all.",
"default": ""
},
"contractType": {
"title": "Tipo de contrato / contract type",
"type": "string",
"description": "Keep only listings whose contract-type label matches (accent- and case-insensitive substring of the label shown on the card). Common values: Indefinido, De duración determinada, Fijo discontinuo, Formativo, De relevo, Autónomo, A tiempo parcial, Otros contratos. Leave empty for all.",
"default": ""
},
"workday": {
"title": "Jornada / workday",
"type": "string",
"description": "Keep only listings whose workday label matches (accent- and case-insensitive substring of the label shown on the card). Common values: Completa, Parcial, Intensiva, Indiferente. Leave empty for all.",
"default": ""
},
"postedSince": {
"title": "Posted within last N days",
"type": "integer",
"description": "Only return listings posted within this many days. InfoJobs shows posting dates as relative Spanish text (e.g. Hace 14m, Hace 2h, Hace 6d, or spelled out as Hace 2 semanas), which is parsed into an approximate age for this filter. The original text is kept as-is in the `postedAtText` output field; `postedAt` holds the computed ISO date/timestamp. Listings whose date text doesn't match a known pattern are always kept (can't be judged, so they're not dropped). Set 0 (default) to disable and return all fetched listings regardless of age.",
"default": 0
},
"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"
}
},
"extractSkills": {
"title": "Extract skill tags (AI)",
"type": "boolean",
"description": "Adds a skills array to each posting — concrete skills, technologies and tools extracted from the title and description excerpt by an LLM and canonicalised to English industry terms (e.g. Python, SAP, Forklift operation). Included in the result price. Fail-open: if extraction is unavailable, skills is null and the run still succeeds.",
"default": true
},
"onlyNewSinceLastRun": {
"title": "Only new since last run (delta mode)",
"type": "boolean",
"description": "Monitoring / delta mode for recurring alert-bot runs: return only postings not seen in a previous run of this Actor, and stamp each with isNew: true. Already-seen offer IDs are remembered in a named key-value store between runs (oldest evicted past 50,000). Keep the same input across scheduled runs so the seen-set stays comparable. Default off.",
"default": false
},
"maxItems": {
"title": "Max items",
"type": "integer",
"description": "Maximum number of postings to return. InfoJobs returns roughly 10–15 cards per page; set 0 for no additional cap.",
"default": 15
},
"timeoutSecs": {
"title": "Request timeout (seconds)",
"type": "integer",
"description": "How long to wait for InfoJobs to respond before giving up, in seconds.",
"default": 25
},
"cacheTtlSeconds": {
"title": "Cache TTL (seconds)",
"type": "integer",
"description": "Reuses the last fetch for this many seconds so rapid re-runs don't hit InfoJobs 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
}
}
}
}
}
}
}
}
}
}