Local Business Coverage Intelligence API

Find local businesses around explicit latitude/longitude centers and return one clean, deduplicated row per business.

What it does

• Searches one or more business categories around explicit coordinates.
• Uses bounded adaptive map coverage rather than a single center query.
• Deduplicates overlapping observations into a stable business row.
• Returns name, category, address, coordinates, rating, review count, website, phone, Google place identifiers, and Maps URL when available.
• Writes a COVERAGE_CERTIFICATE describing the bounded search actually performed.

This Actor does not claim complete coverage of every business in a city or of all Google Maps data. Coverage is bounded by the requested area and selected profile.

Input

Each item in searches accepts:

• query — business category or phrase, e.g. coffee shops
• locationLabel — human-readable area label
• centerLat / centerLng — explicit search center
• radiusKm — square half-width/half-height from 1 to 6 km
• hl / gl — Google language and country context
• optional searchId — stable label for correlating output

coverageProfile:

• QUICK — faster, lower request count
• BALANCED — recommended default
• DEEP — broader bounded coverage at higher runtime/cost

The Actor never infers the user's current location.

Example input

{
  "searches": [
    {
      "searchId": "seattle_coffee",
      "query": "coffee shops",
      "locationLabel": "Seattle, WA",
      "centerLat": 47.6062,
      "centerLng": -122.3321,
      "radiusKm": 2,
      "hl": "en",
      "gl": "us"
    }
  ],
  "coverageProfile": "BALANCED"
}

Output

The default Dataset contains one row per searchId + stableKey. Internal tile, parser, request-hash, and viewport diagnostics are excluded from public Dataset rows.

Main outputs:

• dataset — deduplicated businesses
• summary — run-level counts and field coverage
• coverageCertificate — bounded coverage evidence

Typical fields include name, category, address, latitude, longitude, rating, reviewsCount, website, phone, placeId, cid, featureId, googleMapsUrl, observedTiles, and distanceFromSearchCenterKm.

Pricing

Pay per event:

• business-result: $0.0035 per delivered business
• apify-actor-start: $0.00005 synthetic start event

A business result is charged only after its row has been persisted to the default Dataset. The Actor respects the run spending limit before deciding how many rows can be delivered.

Coverage and data notes

• Results reflect the Google Maps data returned for the requested query, coordinates, language/country context, and run time.
• Optional fields can be unavailable for individual businesses.
• The coverage certificate is not an absolute completeness guarantee.
• Stable identity prioritizes Google place identifiers and deterministic fallbacks.

Programmatic use

Run the Actor from Apify Console, API, clients, MCP/agent integrations, or scheduled tasks. The output schema links directly to the Dataset, summary, and coverage certificate.