AI-Powered Service Area Mapper v2.3 - Claude AI Market Analysis with Drive-Time Polygons

Map service areas with Claude AI-powered market opportunity analysis. BYOK (Bring Your Own Key) - Use your Anthropic API key for AI features: strategic expansion recommendations, competitive gap analysis, demographic trend insights, and territory prioritization. AI Features (BYOK): - Claude AI market opportunity analysis - Expansion priority recommendations - Competitive advantage identification - Demographic trend analysis - Territory planning insights - Revenue potential assessment - Demo mode for testing. v2.1 Features: - Dynamic ZIP code discovery (GeoNames API + Nominatim fallback) - Works for ANY US location, not just specific cities - BYOK: Bring your own GeoNames username for higher rate limits - Automatic fallback to grid-based discovery. v2.0 Features: - Drive-time polygon generation (isochrones) - Configurable drive times (e.g., 15, 30, 45 minutes) - Traffic model options (optimistic, best_guess, pessimistic) - Opportunity heatmap generation - Multiple heatmap metrics (opportunity, population, income, competition) - Adjustable heatmap resolution - GeoJSON export with polygons and points. Core Features: - ZIP code lookup by radius from center point - Census demographics (population, income, age) - Homeownership and housing data - Competitor density analysis - Market opportunity scoring (0-100) - Population and income filtering - Webhook integration (Zapier, Make, n8n). Built by John Rippy (https://www.linkedin.com/in/johnrippy/ | https://johnrippy.link/).

Features

• Radius-Based ZIP Lookup - Find all ZIPs within X miles
• Census Demographics - Population, income, age distribution
• Household Data - Homeownership rates, housing units
• Competitor Density - Businesses per ZIP code
• Opportunity Scoring - High population + low competition = opportunity
• GeoJSON Export - Map your service area visually
• Territory Overlap Detection - Avoid franchise conflicts

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Description
See input schema

Output Format

{
  "zipCode": "75201",
  "city": "Dallas",
  "state": "TX",
  "distanceFromCenter": 2.3,
  "demographics": {
    "population": 12450,
    "medianAge": 34.2,
    "medianHouseholdIncome": 68500,
    "perCapitaIncome": 42000
  },
  "housing": {
    "totalHousingUnits": 8200,
    "ownerOccupied": 3500,
    "renterOccupied": 4200,
    "homeownershipRate": 0.45
  },
  "competition": {
    "competitorCount": 8,
    "competitorsPerCapita": 0.64,
    "saturation": "medium"
  },
  "opportunity": {
    "score": 78,
    "rating": "high",
    "factors": [
      "High population",
      "Above-average income",
      "Low competitor saturation"
    ]
  },
  "coordinates": {
    "latitude": 32.789,
    "longitude": -96.801
  }
}

Pricing

This actor uses pay-per-event billing: This actor uses pay-per-event pricing:

Event	Description	Price
apify-actor-start	Base cost per run	$0.10
zip_analyzed	Per ZIP code analyzed	$0.005
competitor_lookup	Per competitor lookup	$0.01
demographics_fetched	Per demographics query	$0.005

Example costs:

• 100 ZIPs basic: $0.10 + (100 × $0.005) = $0.60
• 100 ZIPs with competitors: $0.10 + (100 × $0.005) + (100 × $0.01) = $1.60
• 300 ZIPs full analysis: $0.10 + (300 × $0.02) = $6.10

Use Cases

• Territory Planning - Define optimal service areas
• Franchise Mapping - Ensure non-overlapping territories
• Market Expansion - Find underserved high-potential areas
• Route Optimization - Group ZIP codes for efficiency
• Competitor Analysis - Find gaps in competitor coverage
• Marketing Targeting - Focus on high-value demographics

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal