📍 GuiaMais Business Scraper

This actor allows you to scrape local business listings from GuiaMais.com.br, Brazil's leading business directory. Extract comprehensive business information including contact details, addresses, operating hours, customer reviews, and more.

Features

• URL-based Scraping: Simply provide a GuiaMais search URL to extract business listings
• Automatic Pagination: Automatically navigates through multiple pages until reaching the end or max items limit
• Comprehensive Business Data: Extract detailed information about each business:
  • Business name and detail page URL
  • Business logo and photo gallery
  • Category/business type
  • Full address with Google Maps integration
  • Operating hours and status (open/closed)
  • Multiple phone numbers
  • WhatsApp contact link
  • Customer ratings and review counts
  • Business images
• Proxy Support: Optional proxy configuration for reliable data collection

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Complete GuiaMais search URL to scrape
maxItems	integer	No	Maximum number of businesses to fetch
proxyConfiguration	object	No	Proxy settings (default: Residential proxy)

How to Get Search URL

1. Go to GuiaMais.com.br
2. Search for businesses using keywords (e.g., "Pizzarias", "Farmácias", "Hotéis")
3. Apply any filters (location, category, etc.)
4. Copy the complete URL from your browser's address bar
5. Paste it into the searchUrl field

Example search URLs:

https://www.guiamais.com.br/encontre?searchbox=true&what=Pizzarias
https://www.guiamais.com.br/encontre?searchbox=true&what=Farmácias&where=São+Paulo
https://www.guiamais.com.br/encontre?searchbox=true&what=Hotéis&where=Rio+de+Janeiro

Output

The output is a dataset of business listing objects, each containing:

• searchUrl: The original search URL used
• name: Business name
• detailUrl: Direct link to the business detail page
• logoImg: URL of the business logo
• category: Business category (e.g., "Pizzarias")
• address: Complete business address
• isClosed: Whether the business is currently closed (true/false)
• openAt: Opening time if currently closed
• phones: Array of phone numbers
• whatsapp: WhatsApp contact link
• rating: Customer rating (1-5 stars)
• reviews: Number of customer reviews
• images: Array of business photo URLs
• mapsUrl: Google Maps URL for the business location
• scrapedAt: Timestamp of when the data was scraped

Example output:

[
  {
    "searchUrl": "https://www.guiamais.com.br/encontre?searchbox=true&what=Pizzarias",
    "name": "PIZZARIA OCIAN II",
    "detailUrl": "https://www.guiamais.com.br/praia-grande-sp/restaurantes/pizzarias/8923304-1/pizzaria-ocian-ii",
    "logoImg": null,
    "category": "Pizzarias",
    "address": "Av Brasil, Boqueirão, Praia Grande - SP, 26 - Aero Club - Praia Grande - SP - 11701-090",
    "isClosed": true,
    "openAt": "18:00",
    "phones": null,
    "whatsapp": "/empresa/redirect?url=https%3A%2F%2Fapi.whatsapp.com%2Fsend...",
    "rating": 4,
    "reviews": 3,
    "images": [
      "https://www.guiamais.com.br/image/q80-p1-c120x120-f120x120-acenter/pizzaria-ocian-ii_64644.webp",
      "https://www.guiamais.com.br/image/q80-p1-c120x120-f120x120-acenter/pizzaria-ocian-ii_64645.webp"
    ],
    "mapsUrl": "https://www.google.com.br/maps/place/Av+Brasil%2C+Boqueir%C3%A3o...",
    "scrapedAt": "2025-11-06T06:53:40.271Z"
  },
  ...
]

Use Cases

• Lead Generation: Build contact lists for sales and marketing campaigns
• Market Research: Analyze business distribution and competition in specific areas
• Directory Building: Create custom business directories for specific industries
• Contact Management: Collect contact information for outreach campaigns
• Local SEO Analysis: Study business listings and local market presence
• Competitive Intelligence: Monitor competitors' presence and ratings
• Data Enrichment: Enhance existing business databases with up-to-date information
• Service Area Mapping: Identify businesses in specific geographic locations

Notes

• The actor works specifically with GuiaMais Brazil (guiamais.com.br)
• Results are saved incrementally as they are discovered
• All timestamps are in ISO 8601 format
• Phone numbers are extracted from clickable links when available
• WhatsApp links include pre-filled messages in Portuguese
• Ratings are on a 1-5 star scale
• Business status (open/closed) is based on current time and business hours

Limitations

• Only works with GuiaMais Brazil website
• Some businesses may not have all information fields available
• Business hours and status depend on data availability on the website
• Images are provided in GuiaMais' optimized format

Tips for Best Results

• Use specific search terms for more targeted results (e.g., "Pizzarias" instead of "Restaurants")
• Include location parameters in your search URL for geo-targeted results
• Set a reasonable maxItems limit based on your needs
• Enable proxy configuration if scraping large datasets or experiencing access issues
• Verify the search results manually before running large-scale scraping jobs

---

Start collecting Brazilian business data from GuiaMais today!