Pricing

from $1.50 / 1,000 results

Try for free

Go to Apify Store

Emprego SAPO Scraper — Portugal Jobs

Try for free

Scrape emprego.sapo.pt — Portugal's leading job board — with employment type · work model · district & work-hours filters plus detailed info from each listing page. Incremental mode tracks new and changed jobs across scheduled runs.

Pricing

from $1.50 / 1,000 results

Rating

0.0

(0)

Developer

Black Falcon Data

Actor stats

Bookmarked

Total users

Monthly active users

23 days ago

Last modified

Categories

Jobs

Lead generation

Automation

You can access the Emprego SAPO Scraper — Portugal Jobs programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "UvTycz6CnEIHTRG1x"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blackfalcondata~emprego-sapo-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blackfalcondata-emprego-sapo-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/blackfalcondata~emprego-sapo-scraper/runs": {
      "post": {
        "operationId": "runs-sync-blackfalcondata-emprego-sapo-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/blackfalcondata~emprego-sapo-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-blackfalcondata-emprego-sapo-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": {
          "query": {
            "title": "🔍 Search Term(s)",
            "type": "string",
            "description": "Job search keywords. Leave empty to return all listings."
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "Portuguese district slug to filter by (e.g. lisboa, porto, braga, setubal). Leave empty for all districts."
          },
          "startUrls": {
            "title": "🔗 Start URLs",
            "type": "array",
            "description": "Paste raw search URLs from emprego.sapo.pt — each URL becomes its own search task; results are merged and deduped by JobId across all tasks. Recognized format: https://emprego.sapo.pt/empregos?keywords=...&location=... Use as alternative to (or alongside) the query/location fields.",
            "items": {
              "type": "string"
            }
          },
          "workHours": {
            "title": "Work Hours",
            "enum": [
              "",
              "full-time",
              "part-time"
            ],
            "type": "string",
            "description": "Filter by work hours type.",
            "default": ""
          },
          "sortOrder": {
            "title": "Sort Order",
            "enum": [
              "mais-recentes",
              "relevancia",
              "mais-antigas",
              "nome-a-z",
              "nome-z-a"
            ],
            "type": "string",
            "description": "Order in which to return results.",
            "default": "mais-recentes"
          },
          "daysOld": {
            "title": "⏰ Days Old",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Only return jobs published within the last N days. 0 = no limit.",
            "default": 0
          },
          "maxResults": {
            "title": "💯 Max Results",
            "minimum": 0,
            "maximum": 9999,
            "type": "integer",
            "description": "Maximum total results (0 = unlimited, up to 9999).",
            "default": 25
          },
          "includeDetails": {
            "title": "📋 Include Full Details",
            "type": "boolean",
            "description": "Fetch full job details from each listing page (full description, validThrough, educationLevel, experienceLevel). Doubles request count.",
            "default": true
          },
          "descriptionMaxLength": {
            "title": "✂️ Description Max Length",
            "minimum": 0,
            "type": "integer",
            "description": "Truncate description to N characters. 0 = no truncation.",
            "default": 0
          },
          "compact": {
            "title": "📦 Compact Output",
            "type": "boolean",
            "description": "Return only core fields (jobId, title, company, location, salary, url, postedAt).",
            "default": false
          },
          "incrementalMode": {
            "title": "♻️ Incremental Mode",
            "type": "boolean",
            "description": "Only emit NEW, UPDATED, and EXPIRED jobs relative to a prior run. Requires stateKey.",
            "default": false
          },
          "stateKey": {
            "title": "🔑 State Key",
            "type": "string",
            "description": "Optional stable identifier for the tracked search universe. Leave empty to auto-derive a stable identifier from your search inputs — different keyword/location/filter combinations get isolated state automatically."
          },
          "emitUnchanged": {
            "title": "♻️ Emit Unchanged",
            "type": "boolean",
            "description": "Also emit UNCHANGED jobs (not just NEW/UPDATED/EXPIRED). Only applies when incrementalMode is true.",
            "default": false
          },
          "emitExpired": {
            "title": "⚰️ Emit Expired",
            "type": "boolean",
            "description": "Also emit jobs that disappeared since the last run (changeType=EXPIRED). Only applies when incrementalMode is true.",
            "default": false
          },
          "skipReposts": {
            "title": "🚫 Skip Reposts",
            "type": "boolean",
            "description": "When incremental, skip jobs that are reposts of previously seen (now expired) jobs.",
            "default": false
          },
          "telegramToken": {
            "title": "🤖 Telegram Bot Token",
            "type": "string",
            "description": "Telegram bot token from @BotFather. Required for Telegram notifications."
          },
          "telegramChatId": {
            "title": "💬 Telegram Chat ID",
            "type": "string",
            "description": "Telegram chat or channel ID where alerts are sent (e.g. \"-100123456789\" for a private group, or \"@yourchannel\")."
          },
          "discordWebhookUrl": {
            "title": "🎮 Discord Webhook URL",
            "type": "string",
            "description": "Discord incoming webhook URL. Get one from Server Settings → Integrations → Webhooks."
          },
          "slackWebhookUrl": {
            "title": "💼 Slack Webhook URL",
            "type": "string",
            "description": "Slack incoming webhook URL. Create at api.slack.com/messaging/webhooks."
          },
          "whatsappPhoneNumberId": {
            "title": "📱 WhatsApp Phone Number ID",
            "type": "string",
            "description": "WhatsApp Business phone number ID from Meta Business Manager (NOT the phone number itself — the numeric ID shown next to your business number). Free service-conversation messages within 24 hours of last user-initiated contact."
          },
          "whatsappAccessToken": {
            "title": "🔐 WhatsApp Access Token",
            "type": "string",
            "description": "Meta Cloud API access token with `whatsapp_business_messaging` scope. Get a permanent token from a system user in Meta Business Manager."
          },
          "whatsappTo": {
            "title": "📨 WhatsApp Recipient",
            "type": "string",
            "description": "Recipient phone in E.164 format (e.g. +351912345678). Recipient must have messaged your business number within the last 24 hours — outside that window, free-form text is rejected by Meta."
          },
          "webhookUrl": {
            "title": "🪝 Generic Webhook URL",
            "type": "string",
            "description": "Generic webhook URL that receives a JSON POST with the full job payload + run metadata. Universal escape hatch for n8n / Make / Zapier / your own backend."
          },
          "webhookHeaders": {
            "title": "🔑 Webhook Headers",
            "type": "object",
            "description": "Optional headers (e.g. {\"Authorization\": \"Bearer xyz\"}) sent with the webhook POST."
          },
          "notificationLimit": {
            "title": "📊 Max Jobs Per Notification",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of jobs included in each notification message (1–20). Excess jobs are still in the dataset; notifications get a summary line.",
            "default": 5
          },
          "notifyOnlyChanges": {
            "title": "🔄 Notify Only New/Updated",
            "type": "boolean",
            "description": "When Incremental Mode is on, only send notifications for NEW / UPDATED / REAPPEARED jobs. Has no effect outside incremental mode.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "all",
              "text",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others.",
            "default": "all"
          },
          "excludeEmptyFields": {
            "title": "Exclude empty fields from output",
            "type": "boolean",
            "description": "Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.",
            "default": false
          },
          "appConnector": {
            "title": "Send results to Notion (or another connected app)",
            "type": "string",
            "description": "Optional. Pick a connected app under Settings → API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog."
          },
          "mcpIssueTeam": {
            "title": "Issue tracker team",
            "type": "string",
            "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Emprego SAPO Data API — Portugal Jobs & Filters OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Emprego SAPO Scraper — Portugal Jobs from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Emprego SAPO Scraper — Portugal Jobs API in Python

Emprego SAPO Scraper — Portugal Jobs API in JavaScript

Emprego SAPO Scraper — Portugal Jobs API through CLI

Emprego SAPO Scraper — Portugal Jobs API

Emprego SAPO Scraper — Portugal Job Listings Data

studio-amba/emprego-sapo-pt-scraper

Scrape job listings from emprego.sapo.pt, the SAPO portal's jobs board in Portugal. Search by keyword, district, and category. Extract job titles, companies, locations, full descriptions, employment type, and posting dates. No login or cookies required.

Studio Amba

Emprego Sapo.Pt Scraper

unfenced-group/emprego-sapo-pt-scraper

Extract job listings from SAPO Emprego, Portugal's leading job board. Get titles, companies, locations, salaries, and contract types as structured JSON.

Unfenced Group

Casa SAPO Scraper - Portugal Real Estate Listings

studio-amba/casa-sapo-pt-scraper

Scrape property listings from Casa SAPO (casa.sapo.pt), Portugal's national property portal. Extract prices, locations, areas, rooms, images, agencies, and geo-coordinates for apartments, houses, land, and commercial properties for sale or rent. No login or cookies required.

Studio Amba

ITJobs.pt Scraper [Just 💰$1.5] — Portugal Tech Jobs

blackfalcondata/itjobs-scraper

💰 $1.5 per 1,000 jobs. Scrape itjobs.pt — Portugal's leading tech job board for developers & analysts with job titles · salaries · contact emails and phones where published. Incremental mode tracks new and changed jobs across scheduled runs.

Black Falcon Data

ITJobs.pt Scraper - Portugal IT Job Listings

studio-amba/itjobs-pt-scraper

Scrape IT and tech job listings from ITJobs.pt, Portugal's leading IT jobs board. Filter by technology category (Java, .NET, DevOps, React, and more). Extract job titles, companies, locations, work mode (remote/hybrid/on-site), employment type, and full descriptions. No login required.

Studio Amba

Work.ua Job Scraper [Just 💰$2] — Ukrainian Job Listings

blackfalcondata/work-ua-scraper

💰 $2 per 1,000 jobs. Scrape work.ua — Ukrainian job listings with full structured description · salary · company & location · employment type per listing. Incremental mode tracks new and changed jobs across scheduled runs.

Black Falcon Data

CASA SAPO Property Discovery Scraper

trovevault/casa-sapo-property-discovery-scraper

Discover public CASA SAPO property listings by location, operation, and property type. Extract prices, areas, rooms, seller labels, images, and listing URLs.

Trove Vault

ITJobs.pt Scraper

solidcode/itjobs-pt-scraper

[💰 $1.3 / 1K] Scrape IT & tech jobs from ITJobs.pt, Portugal's leading technology job board. Get title, company, district, work model, contract type, salary range, tech tags, full description & apply link. Filter by keyword, location, remote/hybrid, contract type, salary and posting date.

SolidCode

Kariera Scraper — Greek Job Listings

blackfalcondata/kariera-scraper

Scrape kariera.gr — Greece's leading job portal for structured job listings with filters for seniority level · employment type · remote work · company details per posting. Incremental mode flags new and changed jobs across scheduled runs.

Black Falcon Data

OLX Job Scraper [Just 💰$1.5] — Jobs across 7 Countries

blackfalcondata/olx-jobs-scraper

💰 $1.5 per 1,000 jobs. Scrape OLX jobs across 7 countries — Poland · Romania · Portugal · Ukraine & 3 more · pick country at run start · keyword or filter search. Incremental mode tracks new and changed jobs across scheduled runs.

Black Falcon Data

5.0