Provided by DataForSEO
Find business listings in selected categories with DataForSEO
Search the Google Maps business listings held by DataForSEO for businesses in the categories you give, up to 100 category ids, optionally narrowed to businesses whose title or description contains given words, to claimed listings only, or to a radius around a coordinate. One row per business: its name, description, category and additional categories, street address with city, region and country, place id, website url and domain, logo and photo count, map coordinates, whether the owner has claimed the listing, and the attributes it offers such as service options, dining options, payments and parking. Pages of up to 100 businesses, with an offset for the next page. One request per call, priced by the vendor's own rate card; an empty result set is reported as no result.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/business_data/business_listings/search/live on Glasser.glasser run -p dataforseo -e '/v3/business_data/business_listings/search/live' -i '{"categories":["pizza_restaurant"]}' --endpoint-version 7Uses endpoint version 7. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/business_data/business_listings/search/live","input":{"categories":["pizza_restaurant"]},"endpoint_version":7}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 7; inspect the current price before running.
Step 2Try a specific example task
When you need to assign a category to a product or topic, you might review the available options to find the closest match.
Copy this prompt into your agent to find a category for your product or topic.
Use dataforseo:/v3/business_data/business_listings/search/live on Glasser.
Find the category that best matches my product or topic in the returned list.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"categories"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"title": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"filters": {
"type": "array",
"description": "DataForSEO filter expression, passed through unchanged: one condition [field, operator, value], or conditions joined by \"and\" / \"or\" ([[a], \"and\", [b]]). Field names come from this endpoint's result items; the number of conditions allowed is in the endpoint's docUrl."
},
"order_by": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 3,
"description": "DataForSEO sorting rules, passed through unchanged: up to 3 \"field,asc\" or \"field,desc\" strings, using the same field names as filters."
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"is_claimed": {
"type": "boolean"
},
"description": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"offset_token": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"location_coordinate": {
"type": "string",
"maxLength": 2048,
"minLength": 1
}
},
"additionalProperties": false
}{
"categories": [
"pizza_restaurant"
]
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Base fee | The same price with or without matching data. | $0.012 |
|---|---|---|
| Per row | For each row returned. | $0.00036 |
| Maximum per Run | The total charge will not exceed this amount. | $0.372 |
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |