Business Listings Search

DataForSEO

Search business listings by category and location with contact, rating and map data.

Capability: Local business search
Current price: $0.0168/request
Availability: Ready to run

What this API does

Search structured business listings by category and location, with optional sorting and result limits.

Agents select this operation with tool ID dataforseo.business-listings-search, then check its current inputs and price before a run.

Inputs and outputs

Input

categoriesarray · optional

DataForSEO business category identifiers.

minItems: 1 · maxItems: 10

descriptionstring · optional

Value supplied for description.

minLength: 1 · maxLength: 200

is_claimedboolean · optional

Value supplied for is claimed.

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

location_coordinatestring · required

latitude,longitude,radius_km; radius must be 1–100000 km.

offsetinteger · optional

Value supplied for offset.

minimum: 0 · maximum: 10000

order_byarray · optional

Value supplied for order by.

maxItems: 3

titlestring · optional

Value supplied for title.

minLength: 1 · maxLength: 200

Output

countnumber

Returned count value.

itemsarray

Returned items value.

total_countnumber

Returned total count value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "dataforseo.business-listings-search",
  "input": {
    "limit": 1,
    "title": "pizza",
    "order_by": [
      "rating.value,desc"
    ],
    "categories": [
      "pizza_restaurant"
    ],
    "location_coordinate": "53.476225,-2.243572,10"
  }
}

Output

{
  "count": 1,
  "items": [
    {
      "type": "business_listing",
      "title": "Jojo's Pizza Bar",
      "rating": {
        "value": 5,
        "rating_type": "Max5",
        "votes_count": 1
      },
      "address": "39 Cross St, Sale M33 7FT",
      "category": "Pizza restaurant",
      "work_time": {
        "work_hours": {
          "current_status": "temporarily_closed"
        }
      }
    }
  ],
  "total_count": 1
}

Errors and limitations

invalid_input: location_coordinate and at least one of categories, title or description are requiredexample: {"categories":["pizza_restaurant"],"location_coordinate":"53.476225,-2.243572,10","limit":1}
configuration_error: DataForSEO account access, funding, or cost controls blocked the request.Fund and verify the server-side DataForSEO account, then retry unchanged.

Use Business Listings Search with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.