scrollport

Back to Find local businesses

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
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

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.