Pai.pt Portugal Business Directory Finder

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.

Open in Apify Store$0.99 / 1K on Free

Short answer

Pai.pt Portugal Business Directory Finder is an Apify Store Actor that returns 9 published output fields, including name, categories, city, street. It lists $0.99 per 1,000 results on the Free plan (pay per event), $0.49 on the Business plan. It takes 11 input settings; one is required (mode). Last updated Nov 20, 2026.

From the public Store listing and published build schema, synced 2026-11-20.
Lead generationAutomationOther

What it returns

9 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

  • name
  • categories
  • city
  • street
  • phone
  • website
  • rating
  • reviewCount
  • sourceUrl

Input

Input settings for Pai.pt Portugal Business Directory Finder
SettingTypeRequiredDefaultWhat it does
mode string Yes search What to fetch: search a category + location, or fetch full business profiles from direct URLs.
category string No restaurantes Business category to search for. Pick a common category from the list, or choose 'Custom category' and type your own slug below (mode=search).
customCategory string No – 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.
location string No – Portuguese city or concelho to search in. Leave as 'Any location (nationwide)' to search the category across all of Portugal (mode=search).
customLocation string No – 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.
sortBy string No ranked How to order search results (mode=search).
openNowOnly boolean No false 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.
minRating string No – 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).
fetchDetails boolean No true 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).
businessUrls array No [] 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.
Show the other 1 settings
More input settings for Pai.pt Portugal Business Directory Finder
SettingTypeRequiredDefaultWhat it does
maxItems integer No 20 Hard cap on the number of business records to return.

Example input

Built from the input form's published example values and defaults.

{
  "mode": "search",
  "category": "restaurantes",
  "location": "lisboa",
  "sortBy": "ranked",
  "openNowOnly": false,
  "fetchDetails": true,
  "businessUrls": [],
  "maxItems": 20
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "mode": "search",
    "category": "restaurantes",
    "location": "lisboa",
    "sortBy": "ranked",
    "openNowOnly": False,
    "fetchDetails": True,
    "businessUrls": [],
    "maxItems": 20
}

run = client.actor("nimbryxo-studio/pai-pt-portugal-business-directory-finder").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

pip install apify-client

JavaScript

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "search",
    "category": "restaurantes",
    "location": "lisboa",
    "sortBy": "ranked",
    "openNowOnly": false,
    "fetchDetails": true,
    "businessUrls": [],
    "maxItems": 20
};

const run = await client.actor("nimbryxo-studio/pai-pt-portugal-business-directory-finder").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

npm install apify-client

cURL

curl -X POST "https://api.apify.com/v2/actors/nimbryxo-studio~pai-pt-portugal-business-directory-finder/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"search","category":"restaurantes","location":"lisboa","sortBy":"ranked","openNowOnly":false,"fetchDetails":true,"businessUrls":[],"maxItems":20}'

Waits for the run and returns the dataset items (runs over 300 seconds return HTTP 408; start an async run instead).

MCP (AI agents)

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=nimbryxo-studio/pai-pt-portugal-business-directory-finder",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

Adds this Actor as a tool in an MCP client that takes a remote server URL (Cursor, VS Code, Claude Code) through Apify's hosted MCP server. OAuth sign-in also works without the header. Clients that only start local servers can wrap the URL with npx mcp-remote.

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

Cost of Pai.pt Portugal Business Directory Finder results by Apify plan
Apify planPer 1,00010,000 results100,000 results
Free plan$0.99$9.90$99
Starter plan$0.82$8.20$82
Scale plan$0.66$6.60$66
Business plan$0.49$4.90$49
  • Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
  • The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
  • Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
  • Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

What people use it for

  • Find Portuguese businesses
  • Collect business contact details

2GIS Business Directory Extractor for CIS & Middle East

Search 2GIS for businesses by category and city across Russia, the UAE, Kazakhstan and the wider CIS, and get name, address, rating, hours,…

66 output fields $0.99 per 1K

Eniro.se Company Directory & Contact Finder

Search Sweden's Eniro.se business directory by category and city, or nationwide, and optionally pull each company's rating, hours, website,…

14 output fields $0.99 per 1K

PanoramaFirm.pl Polish Business Directory Finder

Search PanoramaFirm.pl by category and city or nationwide, or fetch specific profile URLs, with address, phone, website, opening hours, rating,…

18 output fields $0.99 per 1K

YellowPagesPK Business Directory & Lead Finder

Browse Pakistan's YellowPagesPK.com directory by business category, run a keyword search, or fetch full profiles by listing URL. Get business…

10 output fields $0.99 per 1K

1188.lv Latvian Business & Registry Lookup

Search Latvia's 1188.lv directory by keyword or one of 384 categories, or fetch exact business pages, and get address, contact details, rating,…

12 output fields $0.99 per 1K

Booksy Beauty & Wellness Business Profile Scraper

Find salons, barbers, nail studios, spas, and other Booksy businesses by keyword, category, or business ID, with ratings, reviews, staff,…

7 output fields $0.99 per 1K

Questions people ask

How much does Pai.pt Portugal Business Directory Finder cost?

The published result rate depends on your Apify plan: $0.99 per 1,000 on Free, $0.82 per 1,000 on Starter, $0.66 per 1,000 on Scale, $0.49 per 1,000 on Business. So 10,000 results cost about $9.90 on the Free plan and $4.90 on Business, plus a start fee of $0.10 per run per GB of memory on Free. Platform usage is billed separately.

What data does Pai.pt Portugal Business Directory Finder return?

Its published output schema lists 9 fields: name, categories, city, street, phone, website, rating, reviewCount, sourceUrl. A listed field is not guaranteed to be filled in every row.

What input does Pai.pt Portugal Business Directory Finder need?

Required: mode. Optional settings include category, customCategory, location, customLocation, sortBy, openNowOnly.

How do I run Pai.pt Portugal Business Directory Finder from Python or the API?

Use the Apify API client: in Python, ApifyClient(token).actor("nimbryxo-studio/pai-pt-portugal-business-directory-finder").call(run_input=...), then read the run's default dataset (run.default_dataset_id); in JavaScript the same call is client.actor("nimbryxo-studio/pai-pt-portugal-business-directory-finder").call(input). Without a client, POST the input JSON to https://api.apify.com/v2/actors/nimbryxo-studio~pai-pt-portugal-business-directory-finder/run-sync-get-dataset-items with your API token. Ready-to-paste code with the example input is on this page.

Sources

Actor updated 2026-11-20 Data synced 2026-11-20
Cite this page

Scraper Finder. "Pai.pt Portugal Business Directory Finder." https://scraperfinder.com/catalogue/pai-pt-portugal-business-directory-finder/ (data checked 2026-11-20).

Run Pai.pt Portugal Business Directory Finder

$0.99 per 1,000 results. Paste the example input above, set your target query, then export the dataset.

Open in Apify Store