{
  "data": {
    "id": "bjca6XqmexsPYakP0",
    "actId": "LxphDGYpcMil77ktQ",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-20T02:42:32.235Z",
    "finishedAt": "2026-11-20T02:42:49.759Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 17446,
      "runTimeSecs": 17.446,
      "computeUnits": 0.019384444444444444,
      "imageSizeBytes": 334152704
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"PaiPt Scraper Input\",\n  \"description\": \"Search pai.pt (Paginas Amarelas, Portugal's business directory) listings by category and location, or fetch full business profiles by direct URL.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch: search a category + location, or fetch full business profiles from direct URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"detail\"\n      ],\n      \"enumTitles\": [\n        \"Search by category & location\",\n        \"Fetch business profiles by URL\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"category\": {\n      \"title\": \"Category\",\n      \"type\": \"string\",\n      \"description\": \"Business category to search for. Pick a common category from the list, or choose 'Custom category' and type your own slug below (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"custom\",\n        \"restaurantes\",\n        \"advogados\",\n        \"dentistas\",\n        \"cabeleireiros\",\n        \"hoteis\",\n        \"eletricistas\",\n        \"pintores\",\n        \"imobiliarias\",\n        \"funerarias\",\n        \"fisioterapeutas\",\n        \"veterinarios\",\n        \"farmacias\",\n        \"limpezas\",\n        \"mudancas\",\n        \"padarias\",\n        \"talhos\",\n        \"ginasios\",\n        \"clinicas-veterinarias\",\n        \"arquitetos\",\n        \"notarios\",\n        \"seguros\",\n        \"psicologos\",\n        \"pastelarias\",\n        \"cafes\",\n        \"bares\",\n        \"pizzarias\",\n        \"escolas\",\n        \"creches\",\n        \"serralharias\",\n        \"construcao-civil\",\n        \"engenheiros\"\n      ],\n      \"enumTitles\": [\n        \"Custom category (type slug below)\",\n        \"Restaurantes (Restaurants)\",\n        \"Advogados (Lawyers)\",\n        \"Dentistas (Dentists)\",\n        \"Cabeleireiros (Hairdressers)\",\n        \"Hoteis (Hotels)\",\n        \"Eletricistas (Electricians)\",\n        \"Pintores (Painters)\",\n        \"Imobiliarias (Real estate agencies)\",\n        \"Funerarias (Funeral homes)\",\n        \"Fisioterapeutas (Physiotherapists)\",\n        \"Veterinarios (Veterinarians)\",\n        \"Farmacias (Pharmacies)\",\n        \"Limpezas (Cleaning services)\",\n        \"Mudancas (Moving companies)\",\n        \"Padarias (Bakeries)\",\n        \"Talhos (Butchers)\",\n        \"Ginasios (Gyms)\",\n        \"Clinicas veterinarias (Veterinary clinics)\",\n        \"Arquitetos (Architects)\",\n        \"Notarios (Notaries)\",\n        \"Seguros (Insurance)\",\n        \"Psicologos (Psychologists)\",\n        \"Pastelarias (Pastry shops)\",\n        \"Cafes\",\n        \"Bares (Bars)\",\n        \"Pizzarias (Pizzerias)\",\n        \"Escolas (Schools)\",\n        \"Creches (Daycare centers)\",\n        \"Serralharias (Locksmiths / metalworks)\",\n        \"Construcao civil (Construction)\",\n        \"Engenheiros (Engineers)\"\n      ],\n      \"default\": \"restaurantes\",\n      \"prefill\": \"restaurantes\"\n    },\n    \"customCategory\": {\n      \"title\": \"Custom category (overrides selection above)\",\n      \"type\": \"string\",\n      \"description\": \"Free-text pai.pt category URL slug not in the curated list above, e.g. 'canalizadores' or 'oficinas-auto' (mode=search). Takes priority over 'Category' when set.\",\n      \"editor\": \"textfield\"\n    },\n    \"location\": {\n      \"title\": \"Location (concelho / city)\",\n      \"type\": \"string\",\n      \"description\": \"Portuguese city or concelho to search in. Leave as 'Any location (nationwide)' to search the category across all of Portugal (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"custom\",\n        \"lisboa\",\n        \"porto\",\n        \"coimbra\",\n        \"braga\",\n        \"faro\",\n        \"aveiro\",\n        \"setubal\",\n        \"leiria\",\n        \"evora\",\n        \"viseu\",\n        \"guarda\",\n        \"beja\",\n        \"portalegre\",\n        \"santarem\",\n        \"castelo-branco\",\n        \"viana-do-castelo\",\n        \"vila-real\",\n        \"braganca\",\n        \"funchal\",\n        \"ponta-delgada\",\n        \"sintra\",\n        \"cascais\",\n        \"oeiras\",\n        \"almada\",\n        \"amadora\",\n        \"loures\",\n        \"gaia\",\n        \"vila-nova-de-gaia\",\n        \"matosinhos\",\n        \"guimaraes\",\n        \"odivelas\",\n        \"gondomar\",\n        \"maia\",\n        \"barcelos\"\n      ],\n      \"enumTitles\": [\n        \"Any location (nationwide)\",\n        \"Custom location (type slug below)\",\n        \"Lisboa\",\n        \"Porto\",\n        \"Coimbra\",\n        \"Braga\",\n        \"Faro\",\n        \"Aveiro\",\n        \"Setubal\",\n        \"Leiria\",\n        \"Evora\",\n        \"Viseu\",\n        \"Guarda\",\n        \"Beja\",\n        \"Portalegre\",\n        \"Santarem\",\n        \"Castelo Branco\",\n        \"Viana do Castelo\",\n        \"Vila Real\",\n        \"Braganca\",\n        \"Funchal (Madeira)\",\n        \"Ponta Delgada (Azores)\",\n        \"Sintra\",\n        \"Cascais\",\n        \"Oeiras\",\n        \"Almada\",\n        \"Amadora\",\n        \"Loures\",\n        \"Gaia\",\n        \"Vila Nova de Gaia\",\n        \"Matosinhos\",\n        \"Guimaraes\",\n        \"Odivelas\",\n        \"Gondomar\",\n        \"Maia\",\n        \"Barcelos\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"lisboa\"\n    },\n    \"customLocation\": {\n      \"title\": \"Custom location (overrides selection above)\",\n      \"type\": \"string\",\n      \"description\": \"Free-text pai.pt location URL slug not in the curated list above, e.g. 'vila-franca-de-xira' or 'peniche' (mode=search). Takes priority over 'Location' when set.\",\n      \"editor\": \"textfield\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"How to order search results (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"ranked\",\n        \"popular\"\n      ],\n      \"enumTitles\": [\n        \"Classificacao (default ranking)\",\n        \"Mais Popular (most popular)\"\n      ],\n      \"default\": \"ranked\",\n      \"prefill\": \"ranked\"\n    },\n    \"openNowOnly\": {\n      \"title\": \"Open now only\",\n      \"type\": \"boolean\",\n      \"description\": \"Only return businesses that are currently open, computed from each business's opening hours in the Europe/Lisbon timezone (mode=search). Businesses with no published hours are still included.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"string\",\n      \"description\": \"Only return businesses rated at least this many stars, e.g. '4' for 4.0+. Businesses with no rating are still included (ratings are only shown on pai.pt once a business has reviews).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"1\",\n        \"2\",\n        \"3\",\n        \"4\",\n        \"5\"\n      ],\n      \"enumTitles\": [\n        \"No minimum (all businesses)\",\n        \"1+ stars\",\n        \"2+ stars\",\n        \"3+ stars\",\n        \"4+ stars\",\n        \"5 stars only\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"fetchDetails\": {\n      \"title\": \"Fetch full business profiles\",\n      \"type\": \"boolean\",\n      \"description\": \"For each search result, also visit its business profile page to collect address, phone, email, website, coordinates, and full category/tag lists. Recommended -- disable only for a faster, name-only preview scan (mode=search).\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"businessUrls\": {\n      \"title\": \"Business profile URLs (mode=detail)\",\n      \"type\": \"array\",\n      \"description\": \"Direct pai.pt business profile URLs to fetch, e.g. https://www.pai.pt/paginas/161409-restaurantes-pezarroz. Use the 'sourceUrl' field from search results.\",\n      \"editor\": \"requestListSources\",\n      \"items\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"url\": {\n            \"title\": \"URL\",\n            \"type\": \"string\",\n            \"description\": \"pai.pt business profile URL.\"\n          }\n        }\n      },\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on the number of business records to return.\",\n      \"minimum\": 1,\n      \"maximum\": 2000,\n      \"default\": 20,\n      \"prefill\": 20\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Pai.pt Portugal Business Directory Finder\n\nPai.pt (Páginas Amarelas) lists businesses across every district of Portugal, but browsing by trade and city on the site itself means paging through results by hand. This actor searches pai.pt by category and city or concelho — or nationwide — and can enrich each result with the fuller profile data (email, website, coordinates, tags) that only lives on the business's own page.\n\n## What this actor does\n\n- Searches by business category and a Portuguese city or concelho, or leaves location blank to search all of Portugal at once.\n- Offers over 30 curated categories and 34 curated cities/concelhos as ready-to-pick options, with free-text overrides for any category or location slug not on those lists.\n- Optionally visits each result's own profile page to add email, website, GPS coordinates, full category/tag lists, and an \"about\" description.\n- Filters results to businesses currently open (computed from their published hours in the Europe/Lisbon timezone) or at or above a minimum star rating.\n- Only includes a field when pai.pt actually published that value for the business, rather than sending it empty.\n\n## Output per business\n\n| Field | Description |\n|---|---|\n| `name` | Business name |\n| `category` | Category text shown on the search-results card (search mode) |\n| `cardDescription` | Short tagline from the search card, when it differs from the name (search mode; replaced by `description` once a profile is fetched) |\n| `categories` | All registered categories (profile lookups) |\n| `tags` | The business's own keyword tags (profile lookups) |\n| `verticals` | Pai.pt's broader industry vertical(s) for the business (profile lookups) |\n| `description` | The business's own \"about\" text, when published (profile lookups) |\n| `street`, `postalCode`, `city`, `fullAddress` | Address fields, when the source card or profile page shows them |\n| `latitude`, `longitude` | GPS coordinates (profile lookups) |\n| `phone` | Phone number, shown on both the search card and profile page |\n| `email`, `website` | Contact details available only from the business's own profile page |\n| `imageUrl`, `logoUrl` | Listing and logo images |\n| `openingHours` | Structured opening hours per time window |\n| `openingHoursText` | One-line summary of the weekly schedule |\n| `isOpenNow` | Whether the business is open right now, computed from `openingHours` in the Europe/Lisbon timezone |\n| `rating`, `reviewCount` | Average star rating and review count, once the business has at least one review |\n| `searchCategory`, `searchLocation` | The category and location used for this search (search mode only) |\n| `sourceUrl` | Canonical pai.pt profile URL |\n| `recordType` | Always `\"business\"` |\n| `scrapedAt` | UTC timestamp of the scrape |\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` (category + location) or `detail` (fetch specific profile URLs). |\n| `category` | string | `restaurantes` | One of 30+ curated categories, or `custom` to use `customCategory`. |\n| `customCategory` | string | – | Free-text pai.pt category slug, overriding `category` when set. |\n| `location` | string | – (nationwide) | One of 34 curated cities/concelhos, `custom` to use `customLocation`, or blank for all of Portugal. |\n| `customLocation` | string | – | Free-text pai.pt location slug, overriding `location` when set. |\n| `sortBy` | string | `ranked` | `ranked` (pai.pt's default ranking) or `popular` (most popular). |\n| `openNowOnly` | boolean | `false` | Keep only businesses currently open. Businesses with no published hours are still included. |\n| `minRating` | string | – (no minimum) | Keep only businesses rated at least this many stars (`1`-`5`). Businesses with no rating are still included. |\n| `fetchDetails` | boolean | `true` | Visit each result's own profile page for email, website, coordinates, and full category/tag lists. |\n| `businessUrls` | array | `[]` | Pai.pt business profile URLs to fetch directly, in `detail` mode. |\n| `maxItems` | integer | `20` | Maximum number of business records to return. |\n\n### Example: restaurants in Lisbon\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restaurantes\",\n  \"location\": \"lisboa\",\n  \"maxItems\": 30\n}\n```\n\n### Example: highly rated veterinarians in Porto, open now\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"veterinarios\",\n  \"location\": \"porto\",\n  \"minRating\": \"4\",\n  \"openNowOnly\": true,\n  \"maxItems\": 30\n}\n```\n\n### Example: fast name-only scan without profile fetching\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"cafes\",\n  \"location\": \"coimbra\",\n  \"fetchDetails\": false,\n  \"maxItems\": 100\n}\n```\n\n### Example: specific business profiles\n\n```json\n{\n  \"mode\": \"detail\",\n  \"businessUrls\": [\n    { \"url\": \"https://www.pai.pt/paginas/161409-restaurantes-pezarroz\" }\n  ]\n}\n```\n\n## Use cases\n\n- **Trade lead generation** — build a prospect list of electricians, lawyers, or restaurants by concelho for outreach.\n- **Local market research** — compare business density and ratings for a category across Portuguese cities.\n- **Directory or comparison-site building** — feed structured Portuguese business listings into your own local-search product.\n- **Competitor mapping** — see who else operates in a category and area, with hours and contact details.\n- **Franchise and site-selection analysis** — check how saturated a concelho already is for a service before opening there.\n\n## FAQ\n\n**Where does this data come from, and is it affiliated with pai.pt?**\nIt reads the public search and business-profile pages on pai.pt (Páginas Amarelas), Portugal's business directory. This actor is independent and not affiliated with or endorsed by pai.pt.\n\n**Why do some businesses have no rating?**\nPai.pt only shows a rating once a business has received at least one review, so a business with none simply has no `rating`/`reviewCount` fields rather than a misleading `0`.\n\n**What's the difference between `category` and `categories`?**\n`category` is the single text label shown on the search card. `categories` is the full list of categories registered on the business's profile page, and only appears when a profile is fetched (`fetchDetails: true`, or always in `detail` mode).\n\n**Can I search all of Portugal instead of one city?**\nYes — leave `location` blank to search a category nationwide instead of scoping to a city or concelho.\n\n**Why is `fetchDetails` on by default?**\nEmail, website, coordinates, and full category/tag lists only live on a business's own profile page. The search card already carries phone and address, so those fields populate even with `fetchDetails: false` — turn it off only if you want a faster scan and don't need the rest.\n\n**How is `isOpenNow` worked out?**\nThis actor computes it from the business's own published opening hours, checked against the current time in the Europe/Lisbon timezone. If no hours are published, the field is left off rather than guessed.\n\n**What happens with a category or location that doesn't exist on pai.pt?**\nAn unrecognized category returns zero results. An unrecognized location is handled by pai.pt itself, which falls back to a nationwide result set for the category rather than erroring — double-check your location slug if you need city-scoped results.\n\n**Why does `category: \"dentistas\"` combined with a location return nothing?**\nThis is a quirk of pai.pt's own category tree, not an actor bug. Individual dentists on pai.pt are filed under the broader \"clinicas-e-especialidades-medicas\" category and only tagged with the keyword \"dentista\" — there's no `dentistas` node for a specific city. The nationwide `dentistas` search still works because pai.pt resolves it as a keyword search across the whole country. To find dentists in a specific city, search `dentistas` nationwide and filter the results by `city` yourself, or use `customCategory: \"clinicas-e-especialidades-medicas\"` with a location (note this broader category covers other medical specialties too, not dentists exclusively).\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "pai-pt-portugal-business-directory-finder",
      "title": "Pai.pt Portugal Business Directory Finder",
      "description": "Search pai.pt (Páginas Amarelas) by category and Portuguese city or concelho, or nationwide, and optionally pull each business's email, website, coordinates, and opening hours.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Pai.pt Portugal Business Directory Finder\n\nPai.pt (Páginas Amarelas) lists businesses across every district of Portugal, but browsing by trade and city on the site itself means paging through results by hand. This actor searches pai.pt by category and city or concelho — or nationwide — and can enrich each result with the fuller profile data (email, website, coordinates, tags) that only lives on the business's own page.\n\n## What this actor does\n\n- Searches by business category and a Portuguese city or concelho, or leaves location blank to search all of Portugal at once.\n- Offers over 30 curated categories and 34 curated cities/concelhos as ready-to-pick options, with free-text overrides for any category or location slug not on those lists.\n- Optionally visits each result's own profile page to add email, website, GPS coordinates, full category/tag lists, and an \"about\" description.\n- Filters results to businesses currently open (computed from their published hours in the Europe/Lisbon timezone) or at or above a minimum star rating.\n- Only includes a field when pai.pt actually published that value for the business, rather than sending it empty.\n\n## Output per business\n\n| Field | Description |\n|---|---|\n| `name` | Business name |\n| `category` | Category text shown on the search-results card (search mode) |\n| `cardDescription` | Short tagline from the search card, when it differs from the name (search mode; replaced by `description` once a profile is fetched) |\n| `categories` | All registered categories (profile lookups) |\n| `tags` | The business's own keyword tags (profile lookups) |\n| `verticals` | Pai.pt's broader industry vertical(s) for the business (profile lookups) |\n| `description` | The business's own \"about\" text, when published (profile lookups) |\n| `street`, `postalCode`, `city`, `fullAddress` | Address fields, when the source card or profile page shows them |\n| `latitude`, `longitude` | GPS coordinates (profile lookups) |\n| `phone` | Phone number, shown on both the search card and profile page |\n| `email`, `website` | Contact details available only from the business's own profile page |\n| `imageUrl`, `logoUrl` | Listing and logo images |\n| `openingHours` | Structured opening hours per time window |\n| `openingHoursText` | One-line summary of the weekly schedule |\n| `isOpenNow` | Whether the business is open right now, computed from `openingHours` in the Europe/Lisbon timezone |\n| `rating`, `reviewCount` | Average star rating and review count, once the business has at least one review |\n| `searchCategory`, `searchLocation` | The category and location used for this search (search mode only) |\n| `sourceUrl` | Canonical pai.pt profile URL |\n| `recordType` | Always `\"business\"` |\n| `scrapedAt` | UTC timestamp of the scrape |\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` (category + location) or `detail` (fetch specific profile URLs). |\n| `category` | string | `restaurantes` | One of 30+ curated categories, or `custom` to use `customCategory`. |\n| `customCategory` | string | – | Free-text pai.pt category slug, overriding `category` when set. |\n| `location` | string | – (nationwide) | One of 34 curated cities/concelhos, `custom` to use `customLocation`, or blank for all of Portugal. |\n| `customLocation` | string | – | Free-text pai.pt location slug, overriding `location` when set. |\n| `sortBy` | string | `ranked` | `ranked` (pai.pt's default ranking) or `popular` (most popular). |\n| `openNowOnly` | boolean | `false` | Keep only businesses currently open. Businesses with no published hours are still included. |\n| `minRating` | string | – (no minimum) | Keep only businesses rated at least this many stars (`1`-`5`). Businesses with no rating are still included. |\n| `fetchDetails` | boolean | `true` | Visit each result's own profile page for email, website, coordinates, and full category/tag lists. |\n| `businessUrls` | array | `[]` | Pai.pt business profile URLs to fetch directly, in `detail` mode. |\n| `maxItems` | integer | `20` | Maximum number of business records to return. |\n\n### Example: restaurants in Lisbon\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restaurantes\",\n  \"location\": \"lisboa\",\n  \"maxItems\": 30\n}\n```\n\n### Example: highly rated veterinarians in Porto, open now\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"veterinarios\",\n  \"location\": \"porto\",\n  \"minRating\": \"4\",\n  \"openNowOnly\": true,\n  \"maxItems\": 30\n}\n```\n\n### Example: fast name-only scan without profile fetching\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"cafes\",\n  \"location\": \"coimbra\",\n  \"fetchDetails\": false,\n  \"maxItems\": 100\n}\n```\n\n### Example: specific business profiles\n\n```json\n{\n  \"mode\": \"detail\",\n  \"businessUrls\": [\n    { \"url\": \"https://www.pai.pt/paginas/161409-restaurantes-pezarroz\" }\n  ]\n}\n```\n\n## Use cases\n\n- **Trade lead generation** — build a prospect list of electricians, lawyers, or restaurants by concelho for outreach.\n- **Local market research** — compare business density and ratings for a category across Portuguese cities.\n- **Directory or comparison-site building** — feed structured Portuguese business listings into your own local-search product.\n- **Competitor mapping** — see who else operates in a category and area, with hours and contact details.\n- **Franchise and site-selection analysis** — check how saturated a concelho already is for a service before opening there.\n\n## FAQ\n\n**Where does this data come from, and is it affiliated with pai.pt?**\nIt reads the public search and business-profile pages on pai.pt (Páginas Amarelas), Portugal's business directory. This actor is independent and not affiliated with or endorsed by pai.pt.\n\n**Why do some businesses have no rating?**\nPai.pt only shows a rating once a business has received at least one review, so a business with none simply has no `rating`/`reviewCount` fields rather than a misleading `0`.\n\n**What's the difference between `category` and `categories`?**\n`category` is the single text label shown on the search card. `categories` is the full list of categories registered on the business's profile page, and only appears when a profile is fetched (`fetchDetails: true`, or always in `detail` mode).\n\n**Can I search all of Portugal instead of one city?**\nYes — leave `location` blank to search a category nationwide instead of scoping to a city or concelho.\n\n**Why is `fetchDetails` on by default?**\nEmail, website, coordinates, and full category/tag lists only live on a business's own profile page. The search card already carries phone and address, so those fields populate even with `fetchDetails: false` — turn it off only if you want a faster scan and don't need the rest.\n\n**How is `isOpenNow` worked out?**\nThis actor computes it from the business's own published opening hours, checked against the current time in the Europe/Lisbon timezone. If no hours are published, the field is left off rather than guessed.\n\n**What happens with a category or location that doesn't exist on pai.pt?**\nAn unrecognized category returns zero results. An unrecognized location is handled by pai.pt itself, which falls back to a nationwide result set for the category rather than erroring — double-check your location slug if you need city-scoped results.\n\n**Why does `category: \"dentistas\"` combined with a location return nothing?**\nThis is a quirk of pai.pt's own category tree, not an actor bug. Individual dentists on pai.pt are filed under the broader \"clinicas-e-especialidades-medicas\" category and only tagged with the keyword \"dentista\" — there's no `dentistas` node for a specific city. The nationwide `dentistas` search still works because pai.pt resolves it as a keyword search across the whole country. To find dentists in a specific city, search `dentistas` nationwide and filter the results by `city` yourself, or use `customCategory: \"clinicas-e-especialidades-medicas\"` with a location (note this broader category covers other medical specialties too, not dentists exclusively).\n",
      "input": {
        "title": "PaiPt Scraper Input",
        "description": "Search pai.pt (Paginas Amarelas, Portugal's business directory) listings by category and location, or fetch full business profiles by direct URL.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch: search a category + location, or fetch full business profiles from direct URLs.",
            "editor": "select",
            "enum": [
              "search",
              "detail"
            ],
            "enumTitles": [
              "Search by category & location",
              "Fetch business profiles by URL"
            ],
            "default": "search",
            "prefill": "search"
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "Business category to search for. Pick a common category from the list, or choose 'Custom category' and type your own slug below (mode=search).",
            "editor": "select",
            "enum": [
              "custom",
              "restaurantes",
              "advogados",
              "dentistas",
              "cabeleireiros",
              "hoteis",
              "eletricistas",
              "pintores",
              "imobiliarias",
              "funerarias",
              "fisioterapeutas",
              "veterinarios",
              "farmacias",
              "limpezas",
              "mudancas",
              "padarias",
              "talhos",
              "ginasios",
              "clinicas-veterinarias",
              "arquitetos",
              "notarios",
              "seguros",
              "psicologos",
              "pastelarias",
              "cafes",
              "bares",
              "pizzarias",
              "escolas",
              "creches",
              "serralharias",
              "construcao-civil",
              "engenheiros"
            ],
            "enumTitles": [
              "Custom category (type slug below)",
              "Restaurantes (Restaurants)",
              "Advogados (Lawyers)",
              "Dentistas (Dentists)",
              "Cabeleireiros (Hairdressers)",
              "Hoteis (Hotels)",
              "Eletricistas (Electricians)",
              "Pintores (Painters)",
              "Imobiliarias (Real estate agencies)",
              "Funerarias (Funeral homes)",
              "Fisioterapeutas (Physiotherapists)",
              "Veterinarios (Veterinarians)",
              "Farmacias (Pharmacies)",
              "Limpezas (Cleaning services)",
              "Mudancas (Moving companies)",
              "Padarias (Bakeries)",
              "Talhos (Butchers)",
              "Ginasios (Gyms)",
              "Clinicas veterinarias (Veterinary clinics)",
              "Arquitetos (Architects)",
              "Notarios (Notaries)",
              "Seguros (Insurance)",
              "Psicologos (Psychologists)",
              "Pastelarias (Pastry shops)",
              "Cafes",
              "Bares (Bars)",
              "Pizzarias (Pizzerias)",
              "Escolas (Schools)",
              "Creches (Daycare centers)",
              "Serralharias (Locksmiths / metalworks)",
              "Construcao civil (Construction)",
              "Engenheiros (Engineers)"
            ],
            "default": "restaurantes",
            "prefill": "restaurantes"
          },
          "customCategory": {
            "title": "Custom category (overrides selection above)",
            "type": "string",
            "description": "Free-text pai.pt category URL slug not in the curated list above, e.g. 'canalizadores' or 'oficinas-auto' (mode=search). Takes priority over 'Category' when set.",
            "editor": "textfield"
          },
          "location": {
            "title": "Location (concelho / city)",
            "type": "string",
            "description": "Portuguese city or concelho to search in. Leave as 'Any location (nationwide)' to search the category across all of Portugal (mode=search).",
            "editor": "select",
            "enum": [
              "",
              "custom",
              "lisboa",
              "porto",
              "coimbra",
              "braga",
              "faro",
              "aveiro",
              "setubal",
              "leiria",
              "evora",
              "viseu",
              "guarda",
              "beja",
              "portalegre",
              "santarem",
              "castelo-branco",
              "viana-do-castelo",
              "vila-real",
              "braganca",
              "funchal",
              "ponta-delgada",
              "sintra",
              "cascais",
              "oeiras",
              "almada",
              "amadora",
              "loures",
              "gaia",
              "vila-nova-de-gaia",
              "matosinhos",
              "guimaraes",
              "odivelas",
              "gondomar",
              "maia",
              "barcelos"
            ],
            "enumTitles": [
              "Any location (nationwide)",
              "Custom location (type slug below)",
              "Lisboa",
              "Porto",
              "Coimbra",
              "Braga",
              "Faro",
              "Aveiro",
              "Setubal",
              "Leiria",
              "Evora",
              "Viseu",
              "Guarda",
              "Beja",
              "Portalegre",
              "Santarem",
              "Castelo Branco",
              "Viana do Castelo",
              "Vila Real",
              "Braganca",
              "Funchal (Madeira)",
              "Ponta Delgada (Azores)",
              "Sintra",
              "Cascais",
              "Oeiras",
              "Almada",
              "Amadora",
              "Loures",
              "Gaia",
              "Vila Nova de Gaia",
              "Matosinhos",
              "Guimaraes",
              "Odivelas",
              "Gondomar",
              "Maia",
              "Barcelos"
            ],
            "default": "",
            "prefill": "lisboa"
          },
          "customLocation": {
            "title": "Custom location (overrides selection above)",
            "type": "string",
            "description": "Free-text pai.pt location URL slug not in the curated list above, e.g. 'vila-franca-de-xira' or 'peniche' (mode=search). Takes priority over 'Location' when set.",
            "editor": "textfield"
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "How to order search results (mode=search).",
            "editor": "select",
            "enum": [
              "ranked",
              "popular"
            ],
            "enumTitles": [
              "Classificacao (default ranking)",
              "Mais Popular (most popular)"
            ],
            "default": "ranked",
            "prefill": "ranked"
          },
          "openNowOnly": {
            "title": "Open now only",
            "type": "boolean",
            "description": "Only return businesses that are currently open, computed from each business's opening hours in the Europe/Lisbon timezone (mode=search). Businesses with no published hours are still included.",
            "default": false,
            "prefill": false
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "string",
            "description": "Only return businesses rated at least this many stars, e.g. '4' for 4.0+. Businesses with no rating are still included (ratings are only shown on pai.pt once a business has reviews).",
            "editor": "select",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "5"
            ],
            "enumTitles": [
              "No minimum (all businesses)",
              "1+ stars",
              "2+ stars",
              "3+ stars",
              "4+ stars",
              "5 stars only"
            ],
            "default": "",
            "prefill": ""
          },
          "fetchDetails": {
            "title": "Fetch full business profiles",
            "type": "boolean",
            "description": "For each search result, also visit its business profile page to collect address, phone, email, website, coordinates, and full category/tag lists. Recommended -- disable only for a faster, name-only preview scan (mode=search).",
            "default": true,
            "prefill": true
          },
          "businessUrls": {
            "title": "Business profile URLs (mode=detail)",
            "type": "array",
            "description": "Direct pai.pt business profile URLs to fetch, e.g. https://www.pai.pt/paginas/161409-restaurantes-pezarroz. Use the 'sourceUrl' field from search results.",
            "editor": "requestListSources",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "pai.pt business profile URL."
                }
              }
            },
            "default": [],
            "prefill": []
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on the number of business records to return.",
            "minimum": 1,
            "maximum": 2000,
            "default": 20,
            "prefill": 20
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Pai.pt Portugal Business Directory Finder Output",
        "description": "Portuguese business records from pai.pt with address, phone, email, website, opening hours, and coordinates.",
        "properties": {
          "businesses": {
            "type": "string",
            "title": "PaiPt businesses",
            "description": "Dataset containing all scraped pai.pt business listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Businesses",
              "transformation": {
                "fields": [
                  "name",
                  "categories",
                  "city",
                  "street",
                  "phone",
                  "website",
                  "rating",
                  "reviewCount",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.1",
    "imageDigest": "a5b3cdc5b3cee912d342fea5eb13c3e5b37222ddcd87060f9154206b51aa62ac",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.019384444444444444
    }
  }
}