Proporcionado por DataForSEO
Encuentra fichas de empresas en categorías seleccionadas con DataForSEO
Buscar en los listados de negocios de Google Maps que conserva DataForSEO negocios de las categorías indicadas, hasta 100 identificadores de categoría, con la opción de limitar la búsqueda a negocios cuyo título o descripción contenga determinadas palabras, a listados reclamados o a un radio alrededor de unas coordenadas. Una fila por negocio: nombre, descripción, categoría y categorías adicionales, dirección con ciudad, región y país, identificador de lugar, URL y dominio del sitio web, logotipo y cantidad de fotos, coordenadas del mapa, si el propietario ha reclamado el listado y los atributos que ofrece, como opciones de servicio, opciones gastronómicas, medios de pago y estacionamiento. Páginas de hasta 100 negocios, con un desplazamiento para la página siguiente. Una solicitud por llamada, con el precio establecido por el proveedor según sus propias tarifas; un conjunto de resultados vacío se informa como ausencia de resultados.
Cómo ejecutarlo
Paso 1Configurar
Una vez: pega esto en el chat de tu agente. Skill instala el CLI e inicia sesión por sí solo. Si tu agente no puede usar un shell, conéctalo mediante MCP en su lugar.
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 7Usa la versión de endpoint 7. Comprueba el precio actual antes de ejecutar. Instala e inicia sesión primero en Comenzar.
Una vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Ejecútalo y copia este mismo bloque para volver a enviarlo:
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}'Reutiliza la misma Idempotency-Key para volver a enviarlo: el segundo envío es una lectura del primer Run. Una clave nueva crea un Run y un Charge nuevos. Usa la versión de endpoint 7; comprueba el precio actual antes de ejecutar.
Paso 2Prueba una tarea de ejemplo específica
Cuando necesites asignar una categoría a un producto o tema, puedes revisar las opciones disponibles para encontrar la coincidencia más cercana.
Copia este prompt en tu agente para encontrar una categoría para tu producto o tema.
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.Estructura del endpoint
{
"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"
]
}Este endpoint no publica ningún esquema de salida. Recibes el cuerpo de respuesta propio del proveedor de datos, sin cambios — no garantizamos una estructura que no podemos asegurar.
Cómo funcionan los precios
| Tarifa base | El mismo precio con o sin datos coincidentes. | $0.012 |
|---|---|---|
| Por fila | Por cada fila devuelto. | $0.00036 |
| Máximo por Run | El cargo total no superará este importe. | $0.372 |
| Error del proveedor de datos | El proveedor de datos no pudo responder. | $0.00 |
| Tiempo de espera agotado | El Run superó su límite de tiempo. | $0.00 |
| Error interno | Un error interno impidió completar la operación. | $0.00 |