# Business Listings Search

DataForSEO

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

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Business Listings Search (tool ID: dataforseo.business-listings-search). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Find local businesses](https://scrollport.com/tools/google-maps-scraper-api)

**Current price:** $0.0168/request

**Availability:** Ready to run

## Tool details

**About this tool**

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

**Inputs and outputs**

### Input

`categories` array · optional

DataForSEO business category identifiers.

minItems: 1 · maxItems: 10

`description` string · optional

Value supplied for description.

minLength: 1 · maxLength: 200

`is_claimed` boolean · optional

Value supplied for is claimed.

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

`location_coordinate` string · required

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

`offset` integer · optional

Value supplied for offset.

minimum: 0 · maximum: 10000

`order_by` array · optional

Value supplied for order by.

maxItems: 3

`title` string · optional

Value supplied for title.

minLength: 1 · maxLength: 200

### Output

`count` number

Returned count value.

`items` array

Returned items value.

`total_count` number

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.

---

Canonical page: https://scrollport.com/tools/providers/dataforseo/business-listings-search