Find Google Maps business listings

Search DataForSEO’s database for up to three Google Maps business records using a category, name and description text, a coordinate radius, a filter and a sorting rule. Only owner-verified listings are selected.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use business-listings-search-dataforseo for the requested local business search. Reuse the working Toolmu connection; if needed, follow https://toolmu.com/SKILL.md. Honor the existing authorization and budget, and ask only for missing required criteria.
Supply the complete request: categories with one supported identifier; nonempty title and description text, each within 200 characters; location_coordinate as latitude,longitude,radius in km; filters with one complete field/operator/value condition; order_by with one field,direction entry; limit=3; is_claimed=true. A compatible example is pizza_restaurant, title/description pizza, 53.476225,-2.243572,10, [["rating.value",">",3]] and ["rating.value,desc"].
Summarize only returned businesses and available name, address, phone, website, rating/scale, feedback count and hours. Keep null or missing details distinct from zero, and identify contact sources and record dates when provided. Dates describe supplier records or crawler observations, not founding dates or proof of current availability. The chosen sort is a data-field sort, not a Google Maps rank.

Task:
Find up to 3 [pizza places] near [place name or map link] within [10 km], sorted from highest to lowest rating. Include only businesses whose owners confirmed their information and whose rating is above 3 stars. Show available address, phone, website and opening hours; note anything missing.

Paste into your connected AI's conversation.

Connection guide

Up to 0.11 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Find Google Maps business listings

You receive

Get a short list of individual businesses matching your local search criteria. Each record may include the name, address, phone, website, rating and feedback count, and opening hours. Your Agent can put the available details side by side to help you choose businesses to investigate or contact.

Start with your task

Find up to 3 [pizza places] near [place name or map link] within [10 km], sorted from highest to lowest rating. Include only businesses whose owners confirmed their information and whose rating is above 3 stars. Show available address, phone, website and opening hours; note anything missing.

What to know

Up to three records are returned from DataForSEO’s database. This is not a fresh direct Google Maps scrape or a complete local inventory. Details may be missing or outdated; contacts are not independently verified and reported hours do not guarantee that a business is open now.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Search criteria`request`	`object`	Required	Provide all eight fields: category, business-name text, business-description text, center/radius, one filter, one sorting entry, limit=3 and is_claimed=true. There are no omitted-field defaults. Required fields `categories, description, title, is_claimed, location_coordinate, order_by, filters, limit`
Maximum business records`request.limit`	`integer`	Required	Required fixed integer 3. The result can contain fewer than three business records. Fixed value `3`
Business-name text`request.title`	`string`	Required	Nonempty text used to search business names. Native length is 1–256 characters; keep it within the supplier-supported 200 characters. Exact phrase/token matching is not specified. Minimum length `1` Maximum length `256`
One filtering condition`request.filters`	`array`	Required	An outer array containing one condition array. Supply a complete field/operator/value triple, for example [["rating.value",">",3]]. Multiple conditions are not available. Minimum items `1` Maximum items `1`
Condition components`request.filters[]`	`array`	—	The single condition contains 1–3 components structurally; provide all three for a usable field/operator/value comparison. Minimum items `1` Maximum items `3`
Field, operator or comparison value`request.filters[][]`	`string \| integer`	—	Each component is a nonempty 1–256-character string or the integer 3. Use a supported field/operator; the numeric comparison value is fixed at 3, not an adjustable threshold.
One sorting rule`request.order_by`	`array`	Required	An array with exactly one supported field,direction string. Direction is asc or desc; for example ["rating.value,desc"]. This sorts returned records by that field, not Google Maps search positions. Minimum items `1` Maximum items `1`
Sorting field and direction`request.order_by[]`	`string`	—	One nonempty 1–256-character string combines a supported field and direction with a comma, such as rating.value,desc. Minimum length `1` Maximum length `256`
One business category`request.categories`	`array`	Required	An array containing exactly one supplier-supported business category identifier, such as ["pizza_restaurant"]. Minimum items `1` Maximum items `1`
Business category identifier`request.categories[]`	`string`	—	One nonempty 1–256-character identifier. Use a category identifier such as pizza_restaurant rather than assuming any display name is accepted. Minimum length `1` Maximum length `256`
Owner-verified listing`request.is_claimed`	`boolean`	Required	Required fixed true. Selects businesses verified by their owner on Google Maps; it does not certify business quality or the accuracy of contact details. Fixed value `true`
Business-description text`request.description`	`string`	Required	Required nonempty text used to search business descriptions. Native length is 1–256 characters; keep within the supplier-supported 200 characters. Name and description text are both required. Minimum length `1` Maximum length `256`
Search center and radius`request.location_coordinate`	`string`	Required	Required latitude,longitude,radius string, 1–256 characters. Radius is 1–100000 km; latitude/longitude allow at most 7 decimal places. Example: 53.476225,-2.243572,10. Minimum length `1` Maximum length `256`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "categories",
        "description",
        "title",
        "is_claimed",
        "location_coordinate",
        "order_by",
        "filters",
        "limit"
      ],
      "properties": {
        "limit": {
          "type": "integer",
          "const": 3
        },
        "title": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "filters": {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 256,
                  "minLength": 1
                },
                {
                  "type": "integer",
                  "const": 3
                }
              ]
            },
            "maxItems": 3,
            "minItems": 1
          },
          "maxItems": 1,
          "minItems": 1
        },
        "order_by": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1
          },
          "maxItems": 1,
          "minItems": 1
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1
          },
          "maxItems": 1,
          "minItems": 1
        },
        "is_claimed": {
          "type": "boolean",
          "const": true
        },
        "description": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "location_coordinate": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

For supported search fields and their meanings, see the DataForSEO Business Listings Search documentation.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

Provide name and description text as well as the category and coordinate radius. This Tool also requires one complete filter and sorting rule, limit=3 and is_claimed=true. Keep each text within 200 characters. The supplier does not define exact phrase matching or how the two text criteria combine.

Find Google Maps business listings

Find Google Maps business listings

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Describe the place and business

Know what the search includes

Check details before visiting

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Describe the place and business

Know what the search includes

Check details before visiting

Questions about this tool.

Can I search with just a category and area?

What does an owner-verified listing mean?

Can I get more results or add several filters?

How should I interpret ratings and opening hours?

Are contacts and dates current?