Free Lead Count API: know the size of the list before you buy it
The same query as a search, but it costs nothing. The answer tells you whether a category in a city is a handful of businesses or a full sweep, so you can plan credits, quote a client, or decide which cities to cover first.
GET/v1/places/count
{
"data": {
"query": "dentist",
"location": "Lisbon, Portugal",
"count": 50,
"exact": false,
"at_least": true,
"cached": false
},
"meta": {
"request_id": "req_a5ae0d1ce1a1",
"credits_used": 0,
"latency_ms": 1743,
"source": "maps_public",
"geocoded_location": {
"lat": 38.7302,
"lng": -9.1458,
"label": "Lisbon, Portugal"
}
}
}
What you get
Every field in the response.
| Field | Meaning |
|---|---|
count | Businesses on the first result page, up to 50 |
exact | True when the page was not full: that is the whole answer |
at_least | True when 50 came back and a full search will find more |
cached | True when the answer came from the 24 hour cache |
meta.geocoded_location | Where the location resolved to; check it before trusting the number |
How it works
What happens between your request and the response.
One page, no charge
The count runs the first page of the real search and reports its size. Nothing is written to your usage.
Cached for a day
The same query from any key is answered from cache for 24 hours, so the free endpoint stays cheap for everyone.
Capped per key
Each key may ask 50 fresh questions a day; after that the answer is a 429 until tomorrow. Cached answers do not count.
Pricing
One credit system for every endpoint.
Free on every plan, including Free. It does not touch your monthly credits or count as usage.
Questions
Things people ask about the Free Lead Count API.
Why does count stop at 50?
Counting every business in a city would cost as much as fetching them. The first page is enough to tell a small category from a large one; at_least: true means run the search and page until next_page is null.
Can I use it to check a location resolves correctly?
Yes. meta.geocoded_location shows the coordinates and label the location resolved to. Warsaw without a country can resolve to Warsaw, Indiana; Warsaw, Poland cannot.
Does it work for coordinates?
Yes. Pass lat, lng and radius instead of location, exactly as with search.
