🏢 CitySquares Scraper - Extract Local Business Data

Powerful Apify Actor for scraping comprehensive local business listings from CitySquares.com

🎯 What is CitySquares Scraper?

CitySquares Scraper is a professional-grade web scraping tool designed to extract detailed local business information from CitySquares.com. Perfect for lead generation, market research, competitive analysis, and business intelligence gathering.

✨ Key Benefits

• 🚀 High-Speed Extraction: Scrape up to 100+ businesses per minute
• 🛡️ Anti-Detection Technology: Built-in stealth mode with fingerprint rotation
• 📊 Comprehensive Data: Extract 20+ data points including reviews, ratings, and contact info
• 🌍 Geographic Targeting: Search by city, state, or specific locations
• 💰 Cost-Effective: Only $2.80 per 1,000 businesses extracted
• 🔧 Easy to Use: Simple JSON configuration with no coding required

📋 What Data Can You Extract?

🏪 Business Information

• Business Name & Category - Complete business identification
• Contact Details - Phone, website, email (when available)
• Address - Full formatted address with individual components
• Business Hours - Operating schedules for each day
• Services & Description - Business offerings and specialties

⭐ Customer Insights

• Ratings & Reviews - Customer feedback with ratings and text
• Review Count - Total number of customer reviews
• Review Dates - Temporal analysis of customer sentiment

🎁 Marketing Data

• Deals & Promotions - Current offers and discount codes
• Social Media Links - Connected social profiles
• Images & Media - Business photos and visual content

🚀 Quick Start Guide

1️⃣ Basic Search by Category & Location

Perfect for finding specific types of businesses in target areas:

{
    "searchTerms": ["restaurants", "dentists", "plumbers"],
    "locations": ["New York", "Chicago", "Los Angeles"],
    "maxItems": 100,
    "maxReviews": 10
}

2️⃣ Scrape Specific Business Pages

Ideal for targeted data extraction from known URLs:

{
    "startUrls": [
        { "url": "https://citysquares.com/b/new-york-ny" },
        { "url": "https://citysquares.com/s/restaurants/chicago" }
    ],
    "maxItems": 200,
    "scrapeBusinessDetails": true
}

3️⃣ Fast Bulk Extraction

Quickly gather basic business information without detail pages:

{
    "searchTerms": ["electricians"],
    "locations": ["Houston", "Phoenix", "Philadelphia"],
    "scrapeBusinessDetails": false,
    "maxReviews": 0,
    "maxItems": 500,
    "maxConcurrency": 3
}

📊 Input Configuration

Parameter	Type	Default	Description
searchTerms	string[]	[]	Business categories or keywords (e.g., "restaurants", "dentists", "lawyers")
locations	string[]	[]	Target cities, states, or regions
startUrls	object[]	[]	Specific CitySquares URLs to process
maxItems	integer	100	Maximum number of businesses to extract
maxReviews	integer	10	Reviews per business (0 = skip reviews)
includeDeals	boolean	true	Extract deals and promotions
scrapeBusinessDetails	boolean	true	Navigate to detail pages for full data
maxConcurrency	integer	2	Parallel processing (1-20, lower = safer)
maxRuntimeMinutes	integer	5	Auto-stop timeout (1-30 minutes)
proxyConfiguration	object	RESIDENTIAL	Proxy settings for optimal success rates

📤 Output Data Structure

Each business record includes comprehensive information:

{
    "businessName": "Central Park Restaurant",
    "url": "https://citysquares.com/b/central-park-restaurant-123456",
    "category": "Italian Restaurant",
    "address": {
        "street": "123 Broadway",
        "city": "New York",
        "state": "NY",
        "zipCode": "10001",
        "fullAddress": "123 Broadway, New York, NY 10001"
    },
    "phoneNumber": "(212) 555-0123",
    "website": "https://centralparkrestaurant.com",
    "rating": 4.7,
    "reviewCount": 156,
    "reviews": [
        {
            "author": "Sarah Johnson",
            "rating": 5,
            "date": "2024-02-15",
            "text": "Amazing Italian food! Best pasta in NYC."
        }
    ],
    "businessHours": [
        { "day": "Monday", "hours": "11:00 AM - 10:00 PM" },
        { "day": "Tuesday", "hours": "11:00 AM - 10:00 PM" }
    ],
    "deals": [
        {
            "title": "Weekend Special",
            "description": "20% off dinner for two",
            "code": "WEEKEND20"
        }
    ],
    "extractedAt": "2024-02-21T15:30:00.000Z"
}

💰 Pricing & Costs

Feature	Cost
Actor Start	$0.00005 per run
Data Extraction	$0.0028 per business
Bulk Rate	$2.80 per 1,000 businesses

*💡 Cost-Saving Tips:

• Use scrapeBusinessDetails: false for 50% faster, cheaper extraction
• Set maxReviews: 0 to skip review processing
• Lower maxConcurrency to reduce proxy costs

🛠️ Advanced Features

🕵️ Anti-Detection Technology

• Browser Fingerprinting - Randomized browser signatures
• Residential Proxies - Real IP addresses for maximum success
• Session Management - Intelligent request handling
• Rate Limiting - Natural browsing patterns

⚙️ Performance Optimization

• Parallel Processing - Configurable concurrency (1-20)
• Smart Pagination - Automatic page navigation
• Memory Management - Efficient resource usage
• Error Recovery - Robust error handling and retries

🔍 Search Flexibility

• Keyword Search - Find businesses by category or service
• Location Targeting - City, state, or neighborhood specific
• URL Processing - Direct page scraping capabilities
• Mixed Input - Combine search terms and URLs

📈 Use Cases & Applications

🎯 Lead Generation

• Build targeted business databases
• Find potential B2B clients
• Identify sales opportunities by location

📊 Market Research

• Analyze competitive landscapes
• Track business density and trends
• Study pricing and service offerings

🔍 Competitive Intelligence

• Monitor competitor activities
• Analyze customer reviews and ratings
• Track market share and positioning

📱 App Development

• Populate business directories
• Power location-based services
• Enable local search functionality

🚨 Best Practices

✅ Recommended Settings

{
    "maxConcurrency": 2,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    },
    "maxRuntimeMinutes": 10
}

🛡️ Safety Tips

• Start Small: Test with 10-20 items first
• Use Residential Proxies: Essential for high success rates
• Monitor Runtime: Set appropriate timeouts to control costs
• Validate Data: Check sample output before large runs

⚡ Performance Tips

• Disable Details: Use scrapeBusinessDetails: false for speed
• Skip Reviews: Set maxReviews: 0 for faster extraction
• Increase Concurrency: Raise maxConcurrency for faster runs (monitor success rate)
• Target Specific URLs: More efficient than broad searches

🔗 URL Patterns Reference

Business Detail Pages

https://citysquares.com/b/[business-name]-[id]
Example: https://citysquares.com/b/joes-pizza-123456

Search Result Pages

https://citysquares.com/s/[category]/[location]
Example: https://citysquares.com/s/restaurants/new-york

City/Location Pages

https://citysquares.com/b/[city]-[state]
Example: https://citysquares.com/b/chicago-il

🆘 Troubleshooting

Common Issues & Solutions

Issue	Cause	Solution
Low Success Rate	Aggressive concurrency	Reduce maxConcurrency to 1-2
Blocked Requests	Insufficient proxy protection	Ensure residential proxies are enabled
Timeout Errors	Large data extraction	Increase maxRuntimeMinutes or reduce maxItems
Missing Data	Detail scraping disabled	Set scrapeBusinessDetails: true

Error Messages

• "No valid URLs to scrape": Add searchTerms + locations or startUrls
• "Actor reaching timeout": Increase maxRuntimeMinutes or reduce data scope
• "High memory usage": Lower maxConcurrency or enable memory monitoring

📞 Support & Documentation

• 📖 Full Documentation: Apify Actor Page
• 🐛 Bug Reports: GitHub Issues
• 💬 Community Support: Apify Discord
• 📧 Direct Support: support@apify.com

📄 License & Terms

This scraper is provided under the Apify Terms of Service. Users are responsible for complying with CitySquares.com's terms of service and applicable data protection laws.

---

🎯 Ready to extract local business data? Run the CitySquares Scraper on Apify and start building your business database today!

Last updated: February 2024 | Version: 1.0.0