Paginasamarelas Portugal Scraper

What does Paginasamarelas Portugal Scraper do?

Paginasamarelas Portugal Scraper extracts structured Portuguese business listings from pai.pt, the Páginas Amarelas directory — company name, category, address with GPS coordinates, opening hours, rating, and the phone numbers, emails and websites each listing publishes. Search by trade and town or paste a pai.pt search URL, and keep B2B lead lists fresh with incremental runs that return only new or changed businesses.

How to use this actor

• 👉 Register for a free Apify account — no credit card required.
• 🎉 Just click Sign up free on Apify → and complete a quick signup.
• 💰 A free Apify account includes $5 in monthly credits — enough to test this actor.
• ⏳ Scrape during the free trial, with no commitment or upfront payment required.

Key features

• ⭐ Ratings and review counts: rating and reviewCount for every company that has them.
• 📍 Coordinates: latitude and longitude on each company that has a location, ready for a map.
• 🏘️ Address: address, city, country and street as separate fields for every company that lists them.
• 📇 Contact details: phone, phones, website and email where the company publishes them.
• 🕒 Opening hours: hours where the company publishes them.
• 🖼️ Images: images with every image URL, not just the thumbnail.
• 🔍 Keyword search: search pai.pt by keyword with the query input, in the place you name in location.
• 🧭 Radius search: search around a point with lat, lon and radiusKm.
• 🔗 Paste-mode: paste pai.pt URLs into startUrls to scrape exactly the pages you picked in the browser.
• ♻️ Incremental mode: recurring runs emit only directory entries that are new or updated — keep your supplier-outreach lists fresh without re-fetching the full directory. Saves 80–95% on weekly syncs.
• 🔔 Notifications: Telegram, Slack, Discord, WhatsApp Cloud API, and generic webhook out of the box. Pair with incremental for daily new-listing alerts without pipeline glue.

What data can you extract from pai.pt?

Each result includes Core company fields (measuredAt, input, and items). In standard mode, all fields are always present — unavailable data points are returned as null, never omitted. In compact mode, only core fields are returned.

Detail enrichment is on by default and fetches each record's detail page — extra fields the search results omit.

Input

The main inputs are a search keyword, an optional location filter, and a result limit. Additional filters and options are available in the input schema.

Key parameters:

• query — Business type or name to search, e.g. "canalizador", "restaurantes". Required if no startUrls provided.
• location — Portuguese city or area, e.g. "Lisboa". Leave empty for all of Portugal.
• country — Market to search. Páginas Amarelas covers Portugal only. (default: "PT")
• maxResults — Maximum total results (0 = unlimited). (default: 100)
• startUrls — Paste raw search URLs from the target site. Each URL becomes its own search task; results are merged and deduped by listing ID across all URLs. When provided, startUrls REPLACE the query/location fields (each supported URL becomes one task; unsupported URLs are skipped, and if none is supported the run stops with an input error). (default: [])
• includeDetails — Fetch full listing details. (default: true)
• descriptionMaxLength — Truncate description to N chars. 0 = no truncation. (default: 0)
• compact — Core fields only (for AI-agent/MCP workflows). (default: false)
• descriptionFormat — Pick a single description representation. all keeps every variant; text / html / markdown drop the others. (default: "all")
• excludeEmptyFields — Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards. (default: false)
• incrementalMode — Compare against previous run state. stateKey is optional — defaults to a value derived from search inputs (queries, locations, startUrls, country) so different filter sets never share state. (default: false)
• stateKey — Optional. Stable identifier for the tracked search universe. Leave empty to auto-generate from search inputs.
• ...and 23 more parameters

Input examples

Basic search — Keyword-driven search scoped to a city with a tight radius.

→ Full payload per result — all standard fields populated where the source provides them.

{
  "query": "canalizador",
  "location": "Lisboa",
  "radiusKm": 25,
  "maxResults": 50
}

Incremental tracking — Only emit companies that changed since the previous run with this stateKey.

→ First run builds the baseline state. Subsequent runs emit only records that are new or whose tracked content changed. Set emitUnchanged: true to include unchanged records as well.

{
  "query": "canalizador",
  "maxResults": 200,
  "incrementalMode": true,
  "stateKey": "canalizador-tracker"
}

Compact output for AI agents — Return only core fields for AI-agent and MCP workflows.

→ Small payload with the most important fields — ideal for piping into LLMs without token overhead.

{
  "query": "canalizador",
  "maxResults": 50,
  "compact": true
}

Output

Each run produces a dataset of structured company records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console.

Example company record

{
  "measuredAt": "2026-10-22T16:20:55.156Z",
  "input": {
    "query": "canalizador",
    "location": "Lisboa",
    "maxResults": 30,
    "includeDetails": true
  },
  "items": [
    {
      "listingId": "08e69d15dd2d976177da1b9adc8e04504dcbad36043d22a8ad63b1481f3669cb",
      "searchQuery": "canalizador",
      "contentQuality": "full",
      "detailFetched": true,
      "scrapedAt": "2026-10-22T16:19:23.270Z",
      "source": "pai.pt",
      "listing_id": "382925",
      "listing_url": "https://www.pai.pt/paginas/382925-alerta-canalizador-24-horas",
      "name": "Alerta Canalizador 24 Horas",
      "categories": [
        "canalizadores e picheleiros"
      ],
      "phone": "210445812",
      "phones": [
        "210445812"
      ],
      "address": "Lisboa",
      "city": "Lisboa",
      "country": "PT",
      "latitude": 38.7291,
      "longitude": -9.1088,
      "description": "Estamos no ramo há mais de 15 anos, 24 horas por dia, 7 dias por semana, prontos para ajudar o nosso Cliente a solucionar o seu problema de canalização. Contamos com uma vasta experiência relacionado...",
      "services": [
        "Reparação de Canalizações",
        "Deteção de Fugas de Água",
        "Desentupimentos",
        "Desentupimentos de Esgotos"
      ],
      "source_site": "pai.pt",
      "search_query": "canalizador",
      "search_location": "Lisboa",
      "scraped_at": "2026-10-22T16:19:23.270Z",
      "profileUrl": "https://www.pai.pt/paginas/382925-alerta-canalizador-24-horas",
      "portalUrl": "https://www.pai.pt/paginas/382925-alerta-canalizador-24-horas",
      "category": "canalizadores e picheleiros",
      "email": "brigada.canalizador24@gmail.com",
      "images": [
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNFhpQlE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--7be7fd2af58d450c55bf7e64c1d471b9d4805e30/500.jpg",
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNGZpQlE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--32e1f5d317f3bbb45fcb8366859b0e4b3dce4d8e/475.jpg"
      ],
      "logo": "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNFRpQlE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--91f16d934c35fcf134ebde76812ffbdd76ab22be/logotipo2.jpg",
      "sponsored": true
    },
    {
      "listingId": "ae088fa075147a0ac5ef23a38e309109b45c4bb0718a1db9e663169d7ad8d4a4",
      "searchQuery": "canalizador",
      "contentQuality": "full",
      "detailFetched": true,
      "scrapedAt": "2026-10-22T16:19:23.270Z",
      "source": "pai.pt",
      "listing_id": "685446",
      "listing_url": "https://www.pai.pt/paginas/685446-canalizador-de-lisboa",
      "name": "Canalizador de Lisboa",
      "categories": [
        "canalizadores e picheleiros"
      ],
      "phone": "+351927378514",
      "phones": [
        "+351927378514"
      ],
      "address": "Rua Mouzinho da Silveira 32, 1250-167 Lisboa",
      "street": "Rua Mouzinho da Silveira 32",
      "postal_code": "1250-167",
      "city": "Lisboa",
      "country": "PT",
      "latitude": 38.7232,
      "longitude": -9.1506,
      "description": "A Canalizador de Lisboa oferece serviços de canalização e desentupimentos em Lisboa e arredores. Nossa equipe de profissionais qualificados garante soluções rápidas e eficazes para todas as suas neces...",
      "services": [
        "Canalizador et desentupimentos"
      ],
      "opening_hours": [
        "MO 00:00-24:00",
        "TU 00:00-24:00",
        "WE 00:00-24:00",
        "TH 00:00-24:00",
        "FR 00:00-24:00",
        "... 2 more items"
      ],
      "source_site": "pai.pt",
      "search_query": "canalizador",
      "search_location": "Lisboa",
      "scraped_at": "2026-10-22T16:19:23.270Z",
      "profileUrl": "https://www.pai.pt/paginas/685446-canalizador-de-lisboa",
      "portalUrl": "https://www.pai.pt/paginas/685446-canalizador-de-lisboa",
      "category": "canalizadores e picheleiros",
      "email": "info@canalizadordelisboa.pt",
      "website": "https://canalizadordelisboa.pt/",
      "features": [
        "Cartão de Crédito",
        "MBWAY",
        "Transferência Bancária",
        "Visa",
        "Dinheiro"
      ],
      "postalCode": "1250-167",
      "hours": [
        "MO 00:00-24:00",
        "TU 00:00-24:00",
        "WE 00:00-24:00",
        "TH 00:00-24:00",
        "FR 00:00-24:00",
        "... 2 more items"
      ],
      "images": [
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBL1dOQ1E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3207937ffdc1e5327439b4961e7b6d93afaee7c9/Reparac%CC%A7a...",
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBL2FOQ1E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2b61e363689b68ad381a0503ced057a9df456982/Reparac%CC%A7a..."
      ],
      "sponsored": true
    },
    {
      "listingId": "4b107662f7f844a332bc4b259ebe89c68a242609f47f36744108b32a449cdde3",
      "searchQuery": "canalizador",
      "contentQuality": "full",
      "detailFetched": true,
      "scrapedAt": "2026-10-22T16:19:23.270Z",
      "source": "pai.pt",
      "listing_id": "390687",
      "listing_url": "https://www.pai.pt/paginas/390687-o-canalizador",
      "name": "O Canalizador",
      "categories": [
        "canalizadores e picheleiros"
      ],
      "phone": "911143238",
      "phones": [
        "911143238"
      ],
      "address": "Rua 1 3-r/c, 1675-066 Pontinha",
      "street": "Rua 1 3-r/c",
      "postal_code": "1675-066",
      "city": "Pontinha",
      "country": "PT",
      "latitude": 38.7745,
      "longitude": -9.1898,
      "source_site": "pai.pt",
      "search_query": "canalizador",
      "search_location": "Lisboa",
      "scraped_at": "2026-10-22T16:19:23.270Z",
      "profileUrl": "https://www.pai.pt/paginas/390687-o-canalizador",
      "portalUrl": "https://www.pai.pt/paginas/390687-o-canalizador",
      "category": "canalizadores e picheleiros",
      "website": "http://www.ocanalizador.com",
      "postalCode": "1675-066",
      "images": [
        "https://storage.googleapis.com/poetic-primer-235017.appspot.com/public/assets/placeholders/covers/vertical/servicos-1c6685418d3063485a09817ca7e76a3b229103b911ffe51136febb9fc0b89d03.webp"
      ],
      "sponsored": true
    },
    {
      "listingId": "a23e55ef5898bcabb360947785a0c0f64521e81fce34767460e542528e1639c5",
      "searchQuery": "canalizador",
      "contentQuality": "full",
      "detailFetched": true,
      "scrapedAt": "2026-10-22T16:19:23.270Z",
      "source": "pai.pt",
      "listing_id": "458703",
      "listing_url": "https://www.pai.pt/paginas/458703-don-servicos",
      "name": "DON Serviços",
      "categories": [
        "canalizadores e picheleiros"
      ],
      "phone": "937021541",
      "phones": [
        "937021541"
      ],
      "address": "Lisboa",
      "city": "Lisboa",
      "country": "PT",
      "latitude": 38.7538,
      "longitude": -9.2072,
      "description": "Conta com equipes de profissionais com mais de 5 anos de experiências e com equipamentos de alta tecnologia para melhor atender, com serviços de qualidade, agilidade, satisfação e garantia",
      "services": [
        "Desentupimentos",
        "Vídeo Inspeção",
        "Maquina de Alta Pressão",
        "Sistema de Localização",
        "Mau Cheiro",
        "... 4 more items"
      ],
      "opening_hours": [
        "MO 00:00-24:00",
        "TU 00:00-24:00",
        "WE 00:00-24:00",
        "TH 00:00-24:00",
        "FR 00:00-24:00",
        "... 2 more items"
      ],
      "source_site": "pai.pt",
      "search_query": "canalizador",
      "search_location": "Lisboa",
      "scraped_at": "2026-10-22T16:19:23.270Z",
      "profileUrl": "https://www.pai.pt/paginas/458703-don-servicos",
      "portalUrl": "https://www.pai.pt/paginas/458703-don-servicos",
      "category": "canalizadores e picheleiros",
      "email": "donservicos@gmail.com",
      "features": [
        "MBWAY",
        "Transferência Bancária",
        "Dinheiro",
        "Aberto 24h",
        "Aberto aos Fins de Semana",
        "... 2 more items"
      ],
      "rating": 4.6,
      "reviewCount": 16,
      "hours": [
        "MO 00:00-24:00",
        "TU 00:00-24:00",
        "WE 00:00-24:00",
        "TH 00:00-24:00",
        "FR 00:00-24:00",
        "... 2 more items"
      ],
      "images": [
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNkZTQ0E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--17aea936c42e4ca2a27ea766dad14bf9f649d535/logo.JPG",
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOFZQQ0E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--53e352f2f174082002cac56062d9310b96ce1781/rut.JPG"
      ],
      "logo": "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNzVQQ0E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e9bfe57e0c07987b81b0c3ab60c46413473e7673/ukgogu.jpg",
      "sponsored": true
    },
    {
      "listingId": "2a5b5565de80017243ec4b44c84b8918a1afb1dc6e5a4d4cfb558e8e273581e2",
      "searchQuery": "canalizador",
      "contentQuality": "full",
      "detailFetched": true,
      "scrapedAt": "2026-10-22T16:19:23.270Z",
      "source": "pai.pt",
      "listing_id": "692656",
      "listing_url": "https://www.pai.pt/paginas/692656-desentopetop",
      "name": "DesentopeTOP",
      "categories": [
        "canalizadores e picheleiros"
      ],
      "phone": "917801959",
      "phones": [
        "917801959"
      ],
      "address": "estrada nacional 8, lote 6, 2560-581 Torres Vedras",
      "street": "estrada nacional 8, lote 6",
      "postal_code": "2560-581",
      "city": "Torres Vedras",
      "country": "PT",
      "latitude": 39.0589,
      "longitude": -9.2412,
      "description": "A DesentopeTOP é especialista em desentupimentos urgentes 24h em todo Portugal. Atuamos rapidamente na resolução de canos entupidos, esgotos, sanitas, ralos e fossas, com equipamentos profissionais de...",
      "services": [
        "ESGOTOS"
      ],
      "opening_hours": [
        "MO 00:00-24:00",
        "TU 00:00-24:00",
        "WE 00:00-24:00",
        "TH 00:00-24:00",
        "FR 00:00-24:00",
        "... 2 more items"
      ],
      "source_site": "pai.pt",
      "search_query": "canalizador",
      "search_location": "Lisboa",
      "scraped_at": "2026-10-22T16:19:23.270Z",
      "profileUrl": "https://www.pai.pt/paginas/692656-desentopetop",
      "portalUrl": "https://www.pai.pt/paginas/692656-desentopetop",
      "category": "canalizadores e picheleiros",
      "email": "desentopetopp@gmail.com",
      "website": "https://desentopetop.com/",
      "features": [
        "Entregas em 24h",
        "Entregas em 48h",
        "Entregas Grátis",
        "Entregas em todo o País",
        "Entregas nas Ilhas",
        "... 18 more items"
      ],
      "postalCode": "2560-581",
      "rating": 5,
      "reviewCount": 1,
      "hours": [
        "MO 00:00-24:00",
        "TU 00:00-24:00",
        "WE 00:00-24:00",
        "TH 00:00-24:00",
        "FR 00:00-24:00",
        "... 2 more items"
      ],
      "images": [
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdzNuQ1E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--bf7dbb37e18e5edf3760a40f1f5a47f08c4c4c5d/467693315_8705...",
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdy9uQ1E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--42eacc684a8d73ad0b49734eb8dd52b474984d14/4f7ebcc9-5490-...",
        "https://www.pai.pt/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBM2JuQ1E9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2b12e541e2e8282251acd8d5c858df88495015b7/9762024f-e6bc-..."
      ],
      "sponsored": true
    },
    "... 25 more items"
  ]
}

Incremental fields

When incremental mode is on, each record also carries:

• changeType — one of NEW, UPDATED, UNCHANGED, REAPPEARED, EXPIRED. Default output covers NEW / UPDATED / REAPPEARED; set emitUnchanged: true or emitExpired: true to opt into the others.
• isRepost, repostOfId, repostDetectedAt — populated when a new listing matches the tracked content of a previously expired one. Set skipReposts: true to drop detected reposts from the output.

How to scrape pai.pt

1. Go to Paginasamarelas Portugal Scraper in Apify Console.
2. Enter a search keyword and optional location filter.
3. Set maxResults to control how many results you need.
4. Keep includeDetails on (the default) for the extra detail-page fields, or turn it off for faster, cheaper runs.
5. Click Start and wait for the run to finish.
6. Export the dataset as JSON, CSV, or Excel.

Use cases

• Extract company data from pai.pt for market research and competitive analysis.
• Monitor new and changed companies on scheduled runs without processing the full dataset every time.
• Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode.
• Export clean, structured data to dashboards, spreadsheets, or data warehouses.

How much does it cost to scrape pai.pt?

Pricing for Paginasamarelas Portugal Scraper has not been finalized yet. It will be published here before the actor becomes publicly available.

You only use your normal Apify platform resources when you run the actor from your own account.

FAQ

How many results can I get from pai.pt?

The number of results depends on the search query and available companies on pai.pt. Use the maxResults parameter to control how many results are returned per run.

Does Paginasamarelas Portugal Scraper support recurring monitoring?

Yes. Enable incremental mode to only receive new or changed companies on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset.

Can I integrate Paginasamarelas Portugal Scraper with other apps?

Yes. Paginasamarelas Portugal Scraper works with Apify's integrations to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes.

Can I use Paginasamarelas Portugal Scraper with the Apify API?

Yes. You can start runs, manage inputs, and retrieve results programmatically through the Apify API. Client libraries are available for JavaScript, Python, and other languages.

Can I use Paginasamarelas Portugal Scraper through an MCP Server?

Yes. Apify provides an MCP Server that lets AI assistants and agents call this actor directly. Use compact mode, descriptionMaxLength, a single descriptionFormat, and excludeEmptyFields to keep payloads manageable for LLM context windows.

Is it legal to scrape pai.pt?

This actor extracts publicly available data from pai.pt. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant.

Your feedback

If you have questions, need a feature, or found a bug, please open an issue on the actor's page in Apify Console. Your feedback helps us improve.

You might also like

• 1182.ee Scraper - Estonian Business Directory — Scrape the 1182.ee Estonian business directory by keyword and get registry codes, phone numbers.
• 1188.lv Business Directory Scraper — Scrape 1188.lv — Latvia's business directory. Search by keyword or city and get the phone number.
• 2GIS Russia Places Scraper [Just 💰$0.14] — Addresses & Ratings — Scrape 2gis.ru places by keyword and city: addresses and coordinates, categories, ratings.
• Acquire Scraper - Startups & SaaS Businesses for Sale — Scrape startup and SaaS businesses for sale on Acquire.com: filter public listings by keyword.
• Ahrefs Blog Scraper - Posts, Authors & Full Text — Scrape the ahrefs.com blog: search posts by keyword, filter by category, and export title, excerpt,.
• Apontador Brazil Business Scraper — Scrape Apontador — Brazil's local business directory. Search any city and category for business.
• BBB Business Scraper [Just 💰$0.54] — Scrape Better Business Bureau (bbb.org) business profiles in the USA and Canada: BBB rating,.
• Bizi.si Slovenian Company Scraper — Get Slovenian company records from the bizi.si registry: name, registration number, tax ID,.

Getting started with Apify

New to Apify? Create a free account with $5 credit — no credit card required.

1. Sign up — $5 platform credit included
2. Open this actor and configure your input
3. Click Start — export results as JSON, CSV, or Excel

Need more later? See Apify pricing.

Disclaimer

This actor accesses only publicly available data on pai.pt. You are responsible for how you use the extracted data — in particular any personal information such as names, phone numbers, or email addresses — and for complying with Paginasamarelas Portugal's terms of use, applicable data-protection law (including the GDPR where it applies), and the anti-spam rules of your jurisdiction.

This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Paginasamarelas Portugal or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.

Search keywords

pai scraper, pai api, apify pai, pai data extraction, paginasamarelas portugal scraper, paginasamarelas portugal api, apify paginasamarelas portugal, paginasamarelas portugal data extraction, pai.pt scraper, pai.pt data, pai.pt api.