scrollport

Business Listings Search

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

by DataForSEOReady to run$0.0168 per request · $1.68 per 100 requests

Example

You ask your agent

“Find the best-rated pizza restaurant within 10 km of central Manchester.”

You get

Title
Jojo's Pizza Bar
Type
business_listing
Address
39 Cross St, Sale M33 7FT
Category
Pizza restaurant
Rating value
5
Rating type
Max5
Votes count
1
Current status
temporarily_closed
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

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

Response

{
  "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
}

Use it with your agent

Copy the prompt and paste it into your agent, then 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.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 5 →

Questions

Is Business Listings Search by DataForSEO free?

Scrollport has no free tier: it costs $0.0168 per request ($1.68 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from DataForSEO?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to DataForSEO, so you don't sign up with DataForSEO or manage an API key.

Details

About this tool

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

All inputs and outputs

Input

categoriesarray · optional

DataForSEO business category identifiers.

minItems: 1 · maxItems: 10

descriptionstring · optional

minLength: 1 · maxLength: 200

is_claimedboolean · optional
limitinteger · optional

Maximum number of results to return.

minimum: 1 · maximum: 1000

location_coordinatestring · required

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

offsetinteger · optional

Number of results to skip before this page starts.

minimum: 0 · maximum: 10000

order_byarray · optional

Sort order for the results.

maxItems: 3

titlestring · optional

minLength: 1 · maxLength: 200

Output

countnumber
itemsarray

Result records.

total_countnumber

Total number of matching results.

Errors and limits
  • 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: This tool's provider API is currently overloaded or down. Your wallet was not charged.Try again in a few minutes.