Pai.pt Portugal Business Directory Finder avatar

Pai.pt Portugal Business Directory Finder

Pricing

from $0.49 / 1,000 results

Go to Apify Store
Pai.pt Portugal Business Directory Finder

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.

Pricing

from $0.49 / 1,000 results

Rating

0.0

(0)

Developer

Nimbryxo-studio

Nimbryxo-studio

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

19 hours ago

Last modified

Features

Limited permissions

Share

Pai.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.

What this actor does

  • Searches by business category and a Portuguese city or concelho, or leaves location blank to search all of Portugal at once.
  • 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.
  • Optionally visits each result's own profile page to add email, website, GPS coordinates, full category/tag lists, and an "about" description.
  • Filters results to businesses currently open (computed from their published hours in the Europe/Lisbon timezone) or at or above a minimum star rating.
  • Only includes a field when pai.pt actually published that value for the business, rather than sending it empty.

Output per business

FieldDescription
nameBusiness name
categoryCategory text shown on the search-results card (search mode)
cardDescriptionShort tagline from the search card, when it differs from the name (search mode; replaced by description once a profile is fetched)
categoriesAll registered categories (profile lookups)
tagsThe business's own keyword tags (profile lookups)
verticalsPai.pt's broader industry vertical(s) for the business (profile lookups)
descriptionThe business's own "about" text, when published (profile lookups)
street, postalCode, city, fullAddressAddress fields, when the source card or profile page shows them
latitude, longitudeGPS coordinates (profile lookups)
phonePhone number, shown on both the search card and profile page
email, websiteContact details available only from the business's own profile page
imageUrl, logoUrlListing and logo images
openingHoursStructured opening hours per time window
openingHoursTextOne-line summary of the weekly schedule
isOpenNowWhether the business is open right now, computed from openingHours in the Europe/Lisbon timezone
rating, reviewCountAverage star rating and review count, once the business has at least one review
searchCategory, searchLocationThe category and location used for this search (search mode only)
sourceUrlCanonical pai.pt profile URL
recordTypeAlways "business"
scrapedAtUTC timestamp of the scrape

Input

FieldTypeDefaultDescription
modestringsearchsearch (category + location) or detail (fetch specific profile URLs).
categorystringrestaurantesOne of 30+ curated categories, or custom to use customCategory.
customCategorystring–Free-text pai.pt category slug, overriding category when set.
locationstring– (nationwide)One of 34 curated cities/concelhos, custom to use customLocation, or blank for all of Portugal.
customLocationstring–Free-text pai.pt location slug, overriding location when set.
sortBystringrankedranked (pai.pt's default ranking) or popular (most popular).
openNowOnlybooleanfalseKeep only businesses currently open. Businesses with no published hours are still included.
minRatingstring– (no minimum)Keep only businesses rated at least this many stars (1-5). Businesses with no rating are still included.
fetchDetailsbooleantrueVisit each result's own profile page for email, website, coordinates, and full category/tag lists.
businessUrlsarray[]Pai.pt business profile URLs to fetch directly, in detail mode.
maxItemsinteger20Maximum number of business records to return.

Example: restaurants in Lisbon

{
"mode": "search",
"category": "restaurantes",
"location": "lisboa",
"maxItems": 30
}

Example: highly rated veterinarians in Porto, open now

{
"mode": "search",
"category": "veterinarios",
"location": "porto",
"minRating": "4",
"openNowOnly": true,
"maxItems": 30
}

Example: fast name-only scan without profile fetching

{
"mode": "search",
"category": "cafes",
"location": "coimbra",
"fetchDetails": false,
"maxItems": 100
}

Example: specific business profiles

{
"mode": "detail",
"businessUrls": [
{ "url": "https://www.pai.pt/paginas/161409-restaurantes-pezarroz" }
]
}

Use cases

  • Trade lead generation — build a prospect list of electricians, lawyers, or restaurants by concelho for outreach.
  • Local market research — compare business density and ratings for a category across Portuguese cities.
  • Directory or comparison-site building — feed structured Portuguese business listings into your own local-search product.
  • Competitor mapping — see who else operates in a category and area, with hours and contact details.
  • Franchise and site-selection analysis — check how saturated a concelho already is for a service before opening there.

FAQ

Where does this data come from, and is it affiliated with pai.pt? It 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.

Why do some businesses have no rating? Pai.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.

What's the difference between category and categories? 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).

Can I search all of Portugal instead of one city? Yes — leave location blank to search a category nationwide instead of scoping to a city or concelho.

Why is fetchDetails on by default? Email, 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.

How is isOpenNow worked out? This 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.

What happens with a category or location that doesn't exist on pai.pt? An 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.

Why does category: "dentistas" combined with a location return nothing? This 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).