Local Market Saturation & Competitor Density Analyzer
Pricing
from $127.50 / 1,000 market analyzeds
Local competition analysis and competitor density for any business category and location: Google Maps competitor count, rating, review and price distributions, incumbent strength and a 0-1 market saturation score. For site selection and local business market research. Aggregate stats, not leads.
Market
market
Required
The analyzed market, as 'category in location'.
Category
category
Required
Business category requested, echoed verbatim.
Location
location
Required
Location requested, echoed verbatim.
Status
status
Required
'completed' (a report was produced and charged) or 'failed' (no usable results; see error; not charged). Failed also includes uncharged units withheld at Max cost per run.
Competitor count
competitorCount
Optional
Distinct businesses aggregated for this market (deduped across pages). A lower bound on the true count when resultsCapped is true. Null on a failed report.
Results capped
resultsCapped
Optional
True if the maxPlaces cap was hit (more competitors likely exist beyond the sample). Null on a failed report.
Sample truncated
sampleTruncated
Optional
True when a later page could not be collected (deadline, persistent wall, or fetch error). The partial sample is still charged; notice explains why. Independent of the maxPlaces resultsCapped flag.
Rating distribution
rating
Optional
Star-rating aggregates across competitors: mean, median, and a bucketed distribution. Null on a failed report.
Review-count distribution
reviews
Optional
Review-volume aggregates: total reviews across competitors, median, and a bucketed distribution. Null on a failed report.
Price-tier mix
priceMix
Optional
Count of competitors by Google price tier ($ to $$$$), plus 'unknown' where no price is shown. Null on a failed report.
Incumbent strength
incumbentStrength
Optional
How entrenched the field is: fraction rated >= 4.5, fraction with >= 1000 reviews, and the count of strong incumbents (well-rated AND review-deep). Null on a failed report.
Top competitors
topCompetitors
Required
The five most-reviewed incumbents for context (name, rating, review count only — no address, phone, or review text). Empty on a failed report.
[ { "name": "Mozart's Coffee Roasters", "rating": 4.5, "reviewCount": 11000 }, { "name": "Cosmic Pickle", "rating": 4.7, "reviewCount": 4300 }]Saturation score
saturation
Optional
Transparent 0-1 saturation score with band (low/moderate/high), its component signals (density, entrenchment, reviewDepth), and the formula used. A Maps-derived heuristic, not a population-based index. Null on a failed report.
Notice
notice
Required
Standing data-source + disclaimer note on every record: aggregated from public Google Maps listings at request time; a best-effort heuristic over a sample of Google's top-ranked results, not advice.
Error
error
Optional
Clean customer-facing explanation when status is 'failed'. Null on success.
Error class
errorClass
Optional
Machine-routable failure class: 'source_error' is a transient failure to obtain listings — the record's error says whether it was the source or us, and both are worth retrying; 'no_match' means the source answered normally but returned nothing; 'malformed_input' names caller input to correct; 'internal_error' is a fault on our side. Null on success. 'budget_exhausted' means Max cost per run prevented delivery; raise the limit and re-run the named input, uncharged.
Retry advice
retry
Optional
Machine-readable retry guidance for this record, derived from errorClass. Null when the record is a result. 'never' = the source answered, or we do not cover this target: re-running the same input returns the same answer, do not re-run. 'with_changes' = the input for this record must change (see error for what): do not re-run unchanged. 'later' = a transient fault on the source or our side, or the run's budget/deadline ran out before this record: re-run the same input after a short delay.