← Catalog

Google Maps places API: local business listings with ratings and reviews count

local.places

live

Businesses on Google Maps for a query and location: name, category, address, phone, website, rating and review count.

live coverage

DataForSEO: all inputs ✓

Apify: all inputs ✓

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

ProviderStatus
DataForSEO live
Apify live

Billing

Unit: per_search · unmatched results billed: no
Priced per search; the Apify route adds a per-place amount scaling with limit (default 20). The exact quote is reserved before execution. If the provider's actual cost overruns the estimate, the run bills the overrun at the same per-call rate, capped by the hold.

The exact quote is returned by /v1/inspect before every call and held with headroom on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.jell.run/v1/run \
  -H "Authorization: Bearer $JELL_API_KEY" \
  -d '{
    "capability": "local.places",
    "input": { "query": "..." },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "language": {
      "type": "string"
    },
    "limit": {
      "default": 20,
      "type": "integer"
    },
    "location": {
      "description": "City and country (\"Lisbon, Portugal\"), a country (\"France\") or a DataForSEO location code; default United States",
      "type": "string"
    },
    "query": {
      "description": "e.g. \"dentist\", \"coworking space\"",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Normalized output fields

query · places

Used in these guides

Local lead generation with Google Maps listings and reviews →