scrollport

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/call
Availability
Ready to run
Last accepted verification

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 inspect its current executable contract before a run.

Public input and output shape

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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
}
Teaching 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.
Updated
21 August 2026

Use Business Listings Search with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.