DataForSEO Business Listings: Check Location Fields and Repeated City Results

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

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.

Get website and marketing help for your contracting business

KKS builds and manages contractor websites, handles local SEO, and researches your competitors to guide the work. Explore our managed website plans or start with a free audit comparing your business with three competitors.

View website and marketing plans Request my free competitor audit