GuiaMais Brazil Business Directory Scraper

Scrape GuiaMais.com.br — Brazil's leading online business directory. Search any category and city across all 27 Brazilian states, or fetch specific business listing pages directly by URL. Get name, address, phone, category, rating, opening hours, photos, and more. HTTP-only, no login, no cookies, no API key required.

What this actor does

• Two modes: search (category + city, nationwide) and byUrl (fetch specific listing pages directly)
• Geographic scoping: search any Brazilian city (60+ curated major cities plus free-text override for any of Brazil's thousands of municipalities) and filter by any of the 27 states/Distrito Federal (UF)
• Rich business data: name, category, full address (street/neighborhood/city/UF/CEP), phone numbers, WhatsApp number, rating, review count, opening hours, photos, logo
• Optional deep enrichment: turn on fetchDetails to additionally pull GPS coordinates, a Google Maps link, price range, and a full per-weekday opening-hours breakdown
• Filters: state (UF), city, minimum rating, "open now" only, "has photos" only, "verified businesses" only, "delivery available" only, free-text keyword filter
• Empty fields are omitted — every record only contains data actually found for that business
• Full Portuguese/accent support — city, neighborhood, and category names are preserved exactly (São Paulo, Brasília, Piauí, Ceará, Goiânia, etc.)

Output per business

• businessId, sourceUrl — unique ID and canonical GuiaMais listing URL
• name
• category, categoryUrl — business category (e.g. Pizzarias, Restaurantes)
• description
• street, neighborhood, city, state, postalCode, fullAddress
• latitude, longitude, mapUrl — Google Maps link built from coordinates (detail only)
• priceRange (detail only, when published)
• phone, phones[] (all numbers on file), whatsappNumber, whatsappChatUrl — ready-to-send WhatsApp click-to-chat link
• rating (1-5), reviewCount — only present once the business has received reviews
• profileCompleteness — GuiaMais's own 0-100 listing-completeness score
• openNow (boolean), openingHoursSummary (short text), openingSoon/closingSoon (booleans), openingHours[] — per-weekday breakdown {day, dayEn, hours} (detail only)
• logoUrl, photos[]
• verified (boolean), sponsored (boolean), plan — GuiaMais listing tier (free, etc.)
• directionsUrl — GuiaMais-generated Google Maps directions link
• recordType: "business", scrapedAt

(detail only) fields are only populated when fetchDetails: true is set (mode=search) or when using mode: byUrl (which always fetches the full listing page).

Input

Field	Type	Default	Description
mode	string	search	search / byUrl
category	string (enum)	Restaurante	Curated category dropdown with a customCategory free-text override
customCategory	string	–	Free-text category, takes priority over category
city	string (enum)	São Paulo, SP	Curated dropdown of 60 major Brazilian cities with a customCity free-text override
customCity	string	–	Free-text city, format City Name, UF, takes priority over city
state	string (enum)	–	Restrict results to one of Brazil's 27 states/Distrito Federal (UF)
urls	array	–	GuiaMais business listing URLs (mode=byUrl)
keyword	string	–	Keep only results whose name/description/category contain this text
minRating	integer	–	Keep only results rated at or above this value (1-5)
openNowOnly	boolean	false	Only businesses currently marked open
hasPhotosOnly	boolean	false	Only businesses with at least one photo
verifiedOnly	boolean	false	Only businesses GuiaMais marks as verified
deliveryOnly	boolean	false	Only search businesses GuiaMais marks as offering delivery (mode=search; scopes the search itself)
fetchDetails	boolean	false	Visit each business's own listing page for GPS coordinates, map URL, price range, and full opening hours (1 extra request per business)
maxItems	integer	30	Hard cap (1-500)
proxyConfiguration	object	–	Optional; the site works without a proxy, the actor auto-escalates to the free AUTO group on repeated 403/429/503

Example: search with state + minimum rating

{
  "mode": "search",
  "category": "Dentista",
  "city": "Rio de Janeiro, RJ",
  "state": "RJ",
  "minRating": 4,
  "maxItems": 50
}

Example: custom category and city, with full detail enrichment

{
  "mode": "search",
  "customCategory": "Loja de Bicicletas",
  "customCity": "Piracicaba, SP",
  "fetchDetails": true,
  "maxItems": 100
}

Example: fetch specific listing pages

{
  "mode": "byUrl",
  "urls": [
    "https://www.guiamais.com.br/sao-paulo-sp/restaurantes/pizzarias/11230918-3/jatoba-restaurante-pizzaria"
  ]
}

Limitations

• deliveryOnly scopes the GuiaMais search, it isn't a post-fetch record filter. GuiaMais doesn't return a "delivery available" flag on individual business records — only its own search endpoint knows which businesses match, so this input narrows what GuiaMais itself searches rather than filtering records after the fact (like openNowOnly/hasPhotosOnly/verifiedOnly do).
• website and email are not exposed. GuiaMais's public search results and business detail pages do not surface a website link or email address for the businesses sampled during development — these fields simply are not part of the structured data GuiaMais publishes for public (non-logged-in) access, so they are not fabricated or forced into the output.
• rating/reviewCount only appear once a business has received reviews. GuiaMais shows a 0 placeholder for un-reviewed businesses; this actor omits the field entirely in that case rather than emitting a misleading zero.
• Category list is curated, not exhaustive. GuiaMais accepts any Portuguese business/service search term. The category field ships ~55 popular curated examples but accepts any free text via customCategory — it is not a locked taxonomy.
• City list is curated, not exhaustive. Brazil has thousands of municipalities. The city field ships 60 major cities (all state capitals plus other large metros) but accepts any Brazilian city via customCity (format City Name, UF).
• Per-weekday opening hours and GPS coordinates require fetchDetails. These fields only exist on each business's own listing page, not in the search-results list.
• GPS coordinates (latitude/longitude/mapUrl) and priceRange are only present for a subset of businesses even with fetchDetails on. GuiaMais only geocodes/publishes these for some listings; when a business's own page doesn't include them, the fields are simply omitted rather than fabricated.

Use cases

• Lead generation — build prospect lists of local businesses by category, state, and city
• Market research — analyze business density and category coverage across Brazilian states and cities
• Directory aggregation — mirror or cross-reference Brazilian business listings
• Local SEO audits — check a business's own directory data (address, hours, phone, rating) for accuracy
• Franchise/expansion planning — map competitor or partner locations by category and geography
• Sales prospecting — export contact details (phone, WhatsApp) for a target category

FAQ

Do I need a GuiaMais account? No. Search and listing pages are all publicly accessible without an account.

Does the city filter guarantee I only get businesses in that city? city/customCity are used both to scope the GuiaMais search directly (the site's own location-aware search) and as a best-effort text safety-net filter on the returned address.

Does this actor return website or email addresses? No — see Limitations above. GuiaMais does not publish these fields for public search results or listing pages.

Why is rating sometimes missing? Not every business has received reviews yet. The field is omitted rather than returned as 0, which would misleadingly suggest a real (bad) rating.

Why do latitude/longitude/openingHours only appear with fetchDetails on? Those fields only exist on each business's own listing page, not in the search-results list. Turning on fetchDetails fetches that page for every result (one extra request per business, so it's slower but more complete).

Can I search categories or cities not in the dropdowns? Yes — use customCategory and/or customCity to type any Portuguese category or any Brazilian city (format City Name, UF).

How fresh is the data? GuiaMais listings are maintained by business owners and the platform's own data team; the actor always reads the live search results and pages at run time.

Is this actor affiliated with GuiaMais? No. This is an independent, third-party actor that reads GuiaMais's publicly available pages. It is not affiliated with, endorsed by, or sponsored by GuiaMais or its parent company.