{
  "openapi": "3.0.1",
  "info": {
    "title": "Portugal Jobs Feed Empregos: Net-Empregos, SAPO, IEFP, ITJobs",
    "description": "Nine Portuguese job boards (vagas de emprego) in one run: Net-Empregos, Emprego SAPO, IEFP, ITJobs.pt, Eurofirms, Ofertas de Emprego, Expresso Emprego, Alerta Emprego, Landing.jobs. One job format with districts, EUR pay and 14-salary yearly figure, duplicate groups, new, updated or closed jobs.",
    "version": "0.2",
    "x-build-id": "DpEvqqA3oWxwdEb17"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/getascraper~portugal-jobs-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-getascraper-portugal-jobs-feed",
        "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/getascraper~portugal-jobs-feed/runs": {
      "post": {
        "operationId": "runs-sync-getascraper-portugal-jobs-feed",
        "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/getascraper~portugal-jobs-feed/run-sync": {
      "post": {
        "operationId": "run-sync-getascraper-portugal-jobs-feed",
        "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": {
          "sources": {
            "title": "Job boards",
            "type": "array",
            "description": "Which Portuguese job boards to read. Each board is searched with the same keywords, districts and filters, and every row says which board it came from. Six boards are on by default: Net-Empregos and Emprego SAPO (the large general boards), Eurofirms Portugal (agency offers with vacancies and applicant counts), Ofertas de Emprego (work model, languages and experience level), IEFP (the public employment service: gross monthly pay on most offers with full details, but no posting date and no employer name) and ITJobs.pt (IT jobs only). Expresso Emprego, Alerta Emprego (an aggregator of other boards, so expect duplicates) and Landing.jobs (a small tech board) are opt-in: add them when you need them.",
            "items": {
              "type": "string",
              "enum": [
                "net-empregos",
                "eurofirms",
                "ofertas-de-emprego",
                "emprego-sapo",
                "iefp",
                "itjobs-pt",
                "expresso-emprego",
                "alerta-emprego",
                "landing-jobs"
              ],
              "enumTitles": [
                "Net-Empregos (largest general board, all sectors)",
                "Eurofirms Portugal (agency offers, vacancies and applicants)",
                "Ofertas de Emprego (work model, languages, experience level)",
                "Emprego SAPO (large general board)",
                "IEFP (public employment service, gross monthly pay on most offers)",
                "ITJobs.pt (IT jobs)",
                "Expresso Emprego",
                "Alerta Emprego (aggregator)",
                "Landing.jobs (tech)"
              ]
            },
            "default": [
              "net-empregos",
              "eurofirms",
              "ofertas-de-emprego",
              "emprego-sapo",
              "iefp",
              "itjobs-pt"
            ]
          },
          "startUrls": {
            "title": "Board links",
            "type": "array",
            "description": "Optional links copied from a supported board: a search results page or a single job page on any of the nine boards. The board is detected from each link. Empty the Job boards list to read only the pasted links. The run's filters, including employment types, also apply to rows from pasted links. A link that belongs to no supported board is reported and skipped.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Job titles or skills to search, in Portuguese or English, for example enfermeiro, programador or motorista. Accents are optional: tecnico finds técnico. Every keyword is searched in every district. Leave empty to browse the newest jobs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "expandKeywords": {
            "title": "Add Portuguese synonyms for English titles",
            "type": "boolean",
            "description": "Also search a short built-in list of Portuguese titles for common English ones (for example nurse also searches enfermeiro, driver also searches motorista). Finds more jobs and uses more requests.",
            "default": false
          },
          "districts": {
            "title": "Districts or municipalities",
            "type": "array",
            "description": "Any of the 18 districts plus Açores and Madeira (Lisboa, Porto, Braga, Setúbal, Faro ...), or a municipality such as Matosinhos, Oeiras or Funchal. Enter Remote for remote jobs, or Portugal (or leave the list empty) to search the whole country. An unknown place is reported with suggestions and never turned into a whole-country search.",
            "default": [
              "Lisboa"
            ],
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Optional job areas in Portuguese, for example Informática, Hotelaria, Saúde, Logística or Construção. Each board maps the word onto its own category list, and a board with no matching category says so instead of returning unrelated jobs. ITJobs.pt lists IT jobs only: an IT category such as Informática reads the whole board, any other category skips it.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "employmentTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Keep only these kinds of employment. Leave empty for all. Jobs whose type is not stated are dropped when a type is chosen.",
            "items": {
              "type": "string",
              "enum": [
                "fulltime",
                "parttime",
                "internship",
                "temporary",
                "freelance",
                "contract",
                "permanent"
              ],
              "enumTitles": [
                "Full-time (tempo inteiro)",
                "Part-time (tempo parcial)",
                "Internship (estágio)",
                "Temporary (temporário)",
                "Freelance (prestação de serviços)",
                "Fixed-term contract (contrato a termo)",
                "Permanent contract (sem termo)"
              ]
            },
            "default": []
          },
          "remoteOnly": {
            "title": "Remote or hybrid jobs only",
            "type": "boolean",
            "description": "Keep only jobs the board describes as remote (remoto, teletrabalho) or hybrid (híbrido). Jobs that do not say are dropped.",
            "default": false
          },
          "experience": {
            "title": "Experience band",
            "enum": [
              "any",
              "entry",
              "1-3",
              "3-5",
              "5-10",
              "10-plus"
            ],
            "type": "string",
            "description": "Keep jobs whose required experience overlaps this band. Jobs that do not state experience are dropped when a band is chosen.",
            "default": "any"
          },
          "education": {
            "title": "Minimum education",
            "enum": [
              "any",
              "basic",
              "secondary",
              "vocational",
              "bachelor",
              "master",
              "phd"
            ],
            "type": "string",
            "description": "Keep jobs that ask for at least this level. Jobs that do not state an education level are dropped when a level is chosen.",
            "default": "any"
          },
          "minMonthlySalaryEur": {
            "title": "Minimum monthly salary (EUR)",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Keep jobs whose published monthly pay reaches at least this amount. A yearly figure is divided by 14 for this check only (Portugal pays 14 salaries a year). A figure the board prints without saying monthly or yearly cannot be compared and is kept, unless you also tick Only jobs with a published salary. Jobs with no published pay are dropped."
          },
          "maxMonthlySalaryEur": {
            "title": "Maximum monthly salary (EUR)",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Keep jobs whose published monthly pay starts at or below this amount. Yearly figures are divided by 14 for this check only."
          },
          "onlyDisclosedSalary": {
            "title": "Only jobs with a published salary",
            "type": "boolean",
            "description": "Drop jobs whose pay is to be defined (a definir), negotiable or missing. Together with a salary limit, it also drops figures that cannot be compared monthly.",
            "default": false
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Keep jobs posted within this many days (1 keeps today's postings). Jobs that carry no date cannot be checked and are dropped when this is set."
          },
          "companyNames": {
            "title": "Company names",
            "type": "array",
            "description": "Keep only jobs from companies whose name contains one of these words. Accents and legal forms such as Lda or S.A. do not matter.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Drop jobs whose title, company, category, tags or posting text contain any of these words, for example estágio or call center.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeDescription": {
            "title": "Include full description and details",
            "type": "boolean",
            "description": "Add the job description and read each job page for the facts only it shows: requirements, education, languages, vacancies, applicant counts, schedule and the exact posting date. Runs are slower and rows are larger.",
            "default": false
          },
          "includeCompanyProfile": {
            "title": "Include company profile",
            "type": "boolean",
            "description": "Add the employer's profile where the board publishes one (Ofertas de Emprego: about text, website, address, number of open jobs).",
            "default": false
          },
          "includeSourceFields": {
            "title": "Include board source record",
            "type": "boolean",
            "description": "Attach the untouched record read from the board under provenance, for audits and fields not mapped to the common format.",
            "default": false
          },
          "extractContacts": {
            "title": "Extract contact emails and phones",
            "type": "boolean",
            "description": "Pull any email addresses and Portuguese phone numbers printed in the job text into extractedEmails and extractedPhones. Reads only text already fetched, so turn on Include full description for the best results. Nothing is guessed: a job with no published contact gets no field.",
            "default": false
          },
          "convertToUsd": {
            "title": "Add USD salary figures",
            "type": "boolean",
            "description": "Add monthly and annual pay in US dollars using the current exchange rate. If the rate cannot be loaded the USD fields are left out.",
            "default": false
          },
          "monitorScope": {
            "title": "Monitor name",
            "type": "string",
            "description": "Give a name to track this search over time. Each run marks every row NEW, UPDATED, UNCHANGED or REOPENED, and a job that stays gone on two complete scans is reported CLOSED. Use the same name and settings on every scheduled run. Leave empty for a one-off run.",
            "default": ""
          },
          "outputMode": {
            "title": "Output mode",
            "enum": [
              "all",
              "changesOnly",
              "compact"
            ],
            "type": "string",
            "description": "All rows with every field, only rows that are new or changed since the last run, or a short compact row for feeds. Compact rows keep one row per job.",
            "default": "all"
          },
          "uniqueOnly": {
            "title": "One row per job across boards",
            "type": "boolean",
            "description": "When the same job is listed on several boards, keep only the richest copy. Every row carries a cluster id either way, so you can also group them yourself.",
            "default": false
          },
          "includeClosed": {
            "title": "Report closed jobs",
            "type": "boolean",
            "description": "When monitoring, add a short CLOSED row for each job that disappeared on two complete scans. Closed rows count as delivered rows.",
            "default": true
          },
          "maxTotalRows": {
            "title": "Maximum rows in total",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Hard limit on rows delivered by the whole run. It is shared fairly between the boards, and a board that finds less hands its share to the others.",
            "default": 25
          },
          "maxItemsPerSource": {
            "title": "Maximum rows per board",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Most jobs read from one board in this run (split across your keyword, district and category combinations).",
            "default": 25
          },
          "maxPagesPerSource": {
            "title": "Maximum result pages per search",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Most result pages read for each keyword, district and category on a board. A search that stops here is not treated as complete, so it cannot report closed jobs.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. By default each board starts on the cheapest connection that works for it and moves to a proxy only if it is refused. A proxy chosen here is used for every board instead."
          },
          "boardOptions": {
            "title": "Board-specific options",
            "type": "object",
            "description": "Optional per-board settings as JSON, keyed by board id, for filters only one board has. Examples: {\"net-empregos\": {\"categoryIds\": [\"5\"], \"jobTypes\": [\"3\"]}}, {\"eurofirms\": {\"offerType\": \"selection\", \"noExperience\": true}}, {\"emprego-sapo\": {\"qualification\": \"licenciatura\"}}, {\"expresso-emprego\": {\"abroad\": \"include\"}} (adds jobs abroad), {\"landing-jobs\": {\"includeAbroad\": true}} (adds jobs with offices outside Portugal only), {\"ofertas-de-emprego\": {\"includeHtml\": true}}. Unknown keys are ignored.",
            "default": {}
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}