If DataForSEO Business Listings Search returns the same businesses for different cities, inspect the location field before repeating the batch. DataForSEO says Business Listings Search does not support location_name or location_code. Use location_coordinate for a radius search, or filter on the business address to select a city and region. Compare returned business identities and addresses, not only counts. [1][4]
What happened in our contractor search
KKS used Business Listings Search while building a contractor database. Our original write-up describes repeated results when city names were sent in the request. We changed the request to use coordinates and added a country filter. The public repository contains the example scripts and that historical account, but not the original task responses or billing records. [2]
The repeated-city symptom
A low net-new database count can come from deduplication, a narrow category or a repeated response. The KKS write-up describes similar results across city-name requests. To diagnose your own run, compare stable business identifiers and addresses across two distant cities. Matching counts alone do not establish that a location field was ignored. [2]
Test a small pair before scaling
Save the exact payload and response for each request, including task ID, status, returned items and cost. Use the same category, limit and sort for both locations. First inspect any retained city-name payloads and responses that raised the concern. Do not repeat an unsupported request just to recreate the old result. If a new check is authorized and its cost is acceptable, use a documented coordinate or address-filter request on a small scope. Inspect the returned addresses. A plausible row count can still hide businesses outside the intended area. [4]
- Compare IDs or business names and addresses, not only row totals.
- Check the location and country of individual results.
- Keep response rows distinct from records newly inserted after database deduplication.
- Record each task’s billed cost before increasing the batch size.
Use the documented coordinate field
Business Listings Search Live documents location_coordinate in the form latitude,longitude,radius, with the radius in kilometers. The sample below uses the Houston center coordinate from the KKS repository and a 30 km radius. The country filter selects US-coded business addresses; it does not replace the radius or establish a contractor’s service area. The roofing_contractor category comes from the KKS example; this request shape has not been run or checked against a current category catalog. Check the returned locations before importing them. [1][2][3]
POST /v3/business_data/business_listings/search/live
[{
"categories": ["roofing_contractor"],
"location_coordinate": "29.7604,-95.3698,30",
"filters": [["address_info.country_code", "=", "US"]],
"limit": 100,
"order_by": ["rating.value,desc"]
}]For a city without a radius, DataForSEO also documents filters on address_info.city and address_info.region, joined with and. Its Kansas City, Missouri example filters business addresses; it does not define where a contractor works. [4]
The sort requests higher displayed ratings first, not the nearest businesses. A wide radius can change which businesses fill a capped response. Pick a radius for the actual territory, inspect coverage and paginate if you need more results. [1]
What the historical record can show
The KKS repository describes a name-based batch followed by a coordinate-based batch and reports better database yield after the change. Its README is a historical self-report, not a set of saved provider tasks or before-and-after database snapshots. The exact request costs and net-new counts from that account cannot be independently reconciled here. Use the documented request shape and the comparison method, not its batch totals as a forecast for your account. [2]
Why the field matters
DataForSEO explicitly says Business Listings Search and Categories Aggregation do not support location_name or location_code. Its guide offers coordinates or address filters instead. The KKS write-up reports repeated businesses with city-name inputs; its paired responses were not retained. Inspect your saved responses before paying for a new check. [2][4]
Example script and response checks
The KKS example repository contains a discovery script that sets location_coordinate and filters on address_info.country_code. Review its database assumptions before running it. Its diagnostic script makes API requests and would incur provider charges. [2]
The endpoint documents a maximum limit of 1,000 items per response and provides offset and offset_token for pagination. That cap is not a count of all contractors in a metro. A full, rating-sorted page may exclude nearby businesses that rank lower by that sort. [1]
Keep costs and yield separate
For a new run, keep the provider’s task cost, returned rows and database inserts in separate columns. Deduplication can leave few new records even when a task returns many rows. The old KKS README’s batch totals lack task receipts and database cohort snapshots; they cannot establish a per-request price, savings estimate or yield guarantee. Check current pricing and the cost field on each response. [2]
Before a larger batch
Choose a documented coordinate radius or a city-and-region business-address filter. Add a country filter when needed, and inspect the addresses in a small response. An address filter does not establish service area. [4] Save the raw tasks and a deduplication count before changing markets or radius. [1][3]
Questions developers ask
Does Business Listings Search Live use location_name?
No. DataForSEO explicitly says Business Listings Search Live does not support location_name or location_code. Use coordinates or business-address filters instead. KKS reported repeated results from city-name requests, but the original responses are not retained, so that report does not show what the service did with those requests. [2][4]
What units does the coordinate radius use?
The documented radius is in kilometers. A value of 30 in the sample coordinate string specifies a 30 km radius around that point. [1]
How do I filter by country?
Use the address_info.country_code filter for the country you need. Inspect addresses as well; the filter does not establish a business’s service territory. [3]
Does a full response cover the metro?
No. The documented response limit reaches 1,000 items, and the endpoint supports pagination. Coverage also depends on your radius, category and sort order. [1]
Sources
- [1] DataForSEO, Business Listings Search Live request fields. Retained capture reviewed October 15, 2026.
- [2] KKS, Business Listings example repository, historical account and scripts. Retained capture reviewed October 15, 2026.
- [3] DataForSEO, Business Listings available filters. Retained capture reviewed October 15, 2026.
- [4] DataForSEO, How to specify location settings in Business Listings API. Captured November 1, 2026.
Use competitor research to make a website decision
KKS reviews contractor websites and local competitors. A qualified free audit includes a 15-factor scorecard, a comparison with three relevant local competitors when the evidence supports it, and a 90-day action plan. KKS confirms the business, market and scope before accepting the request. Qualified reports are delivered within two business days after that confirmation; a large site or unclear identity may require a narrower scope or more time.