DataForSEO Business Data Business Listings Search

From 14.4 credits/call
ae_dataforseo_business_data_business_listings_search

Search Google Maps business listings via DataForSEO to find local businesses, including details like ratings, reviews, contact info, and working hours.

Maps
From 14.4 credits/call

Pricing

From 14.4 credits/call
ConditionCharge
Base processing fee per call14.4 credits
Per record0.4 credits

Charges depend on the actual returned results.

The starting price is the base query fee; returned records add the listed charges.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].limitinteger | nullNoNo parameter description.—
tasks[].titlestring | nullNoNo parameter description.—
tasks[].offsetinteger | nullNoNo parameter description.—
tasks[].filtersarray | nullNoNo parameter description.—
tasks[].order_byarray | nullNoNo parameter description.—
tasks[].categoriesarray | nullNoNo parameter description.—
tasks[].is_claimedboolean | nullNoNo parameter description.—
tasks[].descriptionstring | nullNoNo parameter description.—
tasks[].offset_tokenstring | nullNoNo parameter description.—
tasks[].location_coordinatestring | nullNoNo parameter description.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_business_data_business_listings_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "limit": 10,
        "title": "AL FURAT AUTO SPARE PARTS TRADING"
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0.01236,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.01236,
      "data": {
        "api": "business_data",
        "function": "search",
        "limit": 10,
        "title": "AL FURAT AUTO SPARE PARTS TRADING"
      },
      "id": "10271507-2802-0544-0000-db2f0116b22e",
      "path": [
        "v3"
      ],
      "result": [
        {
          "count": 1,
          "items": [
            {}
          ],
          "offset": 0,
          "offset_token": "eyJDdXJyZW50T2Zmc2V0IjoxLCJSZXF1ZXN0RGF0YSI6eyJuYW1lIjoiQUwgRlVSQVQgQVVUTyBTUEFSRSBQQVJUUyBUUkFESU5HIiwiZGVzY3JpcHRpb24iOm51bGwsImNhdGVnb3JpZXMiOm51bGwsImNvdW50cnlfY29kZSI6bnVsbCwiY2l0eSI6bnVsbCwiaXNfY2xhaW1lZCI6bnVsbCwib25seV9nb29nbGVfYnVzaW5lc3MiOmZhbHNl",
          "total_count": 1
        }
      ],
      "result_count": 1
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

This example shows part of the response. Copied content is valid JSON.