Notas de campo · 18 de octubre de 2026 · 8 min de lectura

Por qué una búsqueda en Places devuelve 60 negocios y nunca más

Le pides a Google 200 dentistas de una ciudad. Te devuelve 20. Envuelves la paginación en un bucle, te sientes ingenioso, aterrizas exactamente en 60 — y el token desaparece. No es un error de tu bucle: 60 es el techo documentado de Text Search (New). Así funciona la paginación de verdad, cuánto cuesta cada página extra y los cuatro errores que te dejan, en silencio, en la página uno.

El número que nadie lee en la documentación

La referencia de Text Search (New) lo dice sin adornos: una búsqueda devuelve como máximo 60 resultados entre todas sus páginas, y Google agrega que el límite está sujeto a cambios. Veinte por página, tres páginas. No hay parámetro que compre la cuarta: pageSize mueve el tamaño de la página, nunca el techo.

Esa sola frase desarma bastantes planes de negocio hechos sobre «raspar todos los gasfíteres del país en una corrida». También explica una pregunta de soporte que recibimos seguido: «el flujo encontró 60 leads y se detuvo, ¿está roto?». No. Hizo exactamente lo que la API permite.

Los tres campos que hacen todo el trabajo

Dos detalles se pierden en casi todos los tutoriales. Primero, maxResultCount está obsoleto: lo reemplazó pageSize, y si mandas los dos gana pageSize y el campo viejo se ignora. Segundo, nextPageToken tiene que estar en tu máscara de campos. Pertenece al tramo IDs-only (Essentials), así que incluirlo no cuesta nada extra — pero si lo olvidas, la respuesta no trae token, tu bucle cree que la página uno era la última y juntas 20 resultados en vez de 60. Ese fallo se ve como «la consulta es mala», y por eso uno depura la cosa equivocada durante una hora.

Cómo pagina nuestro flujo — la configuración, literal

El flujo del kit no usa un bucle en un nodo Code. Usa la paginación propia del nodo HTTP Request, que es más fácil de auditar y sobrevive mejor a las actualizaciones de nodos:

Las dos condiciones importan y hacen cosas distintas. La condición de parada es la razón correcta para parar; el tope de solicitudes es la razón segura. Con las dos nunca pagas una página que la API no pensaba darte.

Cuánto cuesta cada página, con la aritmética a la vista

En Places API (New) se factura por solicitud, según la SKU más alta presente en la máscara de esa solicitud. Una llamada paginada no es una solicitud con tres páginas: son tres solicitudes, cada una con su propia máscara, así que la factura se multiplica por las páginas de una forma fácil de olvidar.

Mira la forma de la última fila: mil leads son cincuenta solicitudes, no una. Si estás dentro del tramo gratuito mensual de esa SKU, esos mismos mil leads cuestan cero — por eso «cuántas solicitudes por corrida» y «cuántas corridas al mes» son los dos números que deciden tu factura, y por eso un tope de tres páginas es una decisión de precio tanto como una decisión de ingeniería.

Entonces, ¿cómo se consiguen más de 60?

No con una página más grande. Partiendo la pregunta:

1. Por zona. Corre el mismo nicho una vez por comuna o ciudad en vez de una vez por toda la región. El techo es por búsqueda, así que diez comunas son diez techos.
2. Por redacción del nicho. clinica dental, dentista y ortodoncista son tres búsquedas distintas que se solapan — y no importa, porque el punto siguiente elimina el solape.
3. Con deduplicación por placeId. Esto es lo que hace segura la estrategia: deduplicas antes de gastar en IA, y un negocio que ya salió en la corrida de ayer no se paga dos veces.

Nuestro propio flujo aprendió la versión honesta de esto: su nodo de deduplicación recuerda hasta 5.000 placeId entre ejecuciones, así que una segunda corrida de la misma consulta devuelve legítimamente cero filas nuevas. Tampoco es un bug — es la función haciendo su trabajo, y se reinicia con Clear Deduplication History cuando de verdad quieres volver a ver los mismos negocios.

Cuatro errores que te dejan en la página uno

Qué significa esto si vas a comprar una plantilla

Pregúntale dos cosas al vendedor: «¿cuántas páginas, y qué detiene el bucle?». Una plantilla que pagina sin tope es una plantilla que puede gastar tu presupuesto sin preguntarte. Una que se detiene solo por un número fijo pagará contenta una página vacía. La respuesta que quieres menciona las dos cosas: parada por token y tope duro.

La nuestra está publicada completa — la máscara de campos, la tabla de SKU, el tope de páginas y el costo medido en tokens por lead — en el documento de costos que viene dentro del kit. Si prefieres revisar la aritmética antes de comprar y no después, ese documento es la versión larga de este artículo.