Google Maps API
Descubra lugares públicos, consulte detalles normalizados de URL conocidas de Maps y obtenga reseñas públicas con contexto del lugar y del autor vinculado a la fuente.
API de Google Maps disponibles
Use Search para descubrir lugares por consulta y ubicación, Place Details para URL conocidas de Maps y Reviews para obtener reseñas públicas de forma acotada.
¿Qué datos de Google Maps se pueden obtener?
SocQ devuelve registros públicos PlaceItem normalizados para investigación de ubicaciones, descubrimiento de negocios, enriquecimiento de datos e instantáneas de mercado de un momento dado.
Identidad del lugar
Obtenga los ID de lugar, nombres, categorías, URL de origen, tipos de registro y marcas de tiempo de recolección que estén disponibles.
Direcciones y contexto geográfico
Conserve las direcciones con formato, las etiquetas de ubicación, las ciudades, las regiones, los países, la latitud y la longitud que estén disponibles.
Datos de contacto públicos
Obtenga teléfonos y sitios web públicos cuando un resultado de búsqueda los expone.
Calificaciones y conteo de reseñas
Conserve la calificación y la cantidad de reseñas que informa la fuente, sin inferir los valores ausentes.
Descripciones y categorías
Use el texto de resumen y las etiquetas de categoría disponibles para clasificar y preseleccionar los resultados de lugares.
Metadatos de tareas y paginación
Dé seguimiento al estado de la tarea y a result_count, y recorra los registros PlaceItem almacenados con next_cursor y has_more.
Texto de ubicación y contexto de coordenadas
Google Maps Search siempre requiere query y location. En la especificación actual de ejecución, las coordenadas son contexto opcional y no reemplazan a location.
| Opción de entrada | Comportamiento en ejecución | Cuándo usarla |
|---|---|---|
| Solo location | El texto de la ubicación se combina con query para el descubrimiento | Búsquedas basadas en una ciudad, un distrito, un punto de referencia o una dirección |
| location más ambas coordenadas | location sigue siendo obligatorio y las coordenadas se reenvían como lat y long | Se dispone de un centro geográfico verificado |
| location más una coordenada | La coordenada indicada se reenvía de forma independiente | Úsela solo cuando el contexto geográfico parcial sea intencional |
| country y zoom_level | El contexto opcional se reenvía junto con la fila de búsqueda | La solicitud necesita una pista de país o un zoom explícito de 0 a 21 |
Cómo funciona la API de Google Maps
Envíe una búsqueda de lugares acotada, espere la recolección asíncrona y recorra los registros normalizados almacenados para la tarea.
1. Definir la búsqueda de lugares
Elija una query específica y la location obligatoria, y agregue solo el contexto geográfico opcional verificado que necesite.
2. Enviar y dar seguimiento a la tarea
Envíe la solicitud por POST, guarde el task_id y consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o con error.
3. Leer los lugares normalizados
Procese data.results.items y siga next_cursor mientras has_more sea true.
Envíe una query y una location con un tope de resultados pequeño, y luego lea los resultados PlaceItem normalizados desde el endpoint de tareas compartido.
curl -X POST "https://api.socq.ai/v1/google-maps/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso frecuentes de la API de Google Maps
Descubrimiento de negocios locales
Encuentre negocios públicos que coincidan con una categoría o un servicio dentro de una ciudad, un distrito, un punto de referencia o una dirección.
Enriquecimiento de datos de lugares
Agregue los campos disponibles de contacto, dirección, categoría, calificación, conteo de reseñas, URL y coordenadas a lugares candidatos que ya tenga.
Instantáneas de mercados geográficos
Obtenga conjuntos de resultados acotados para zonas enviadas de forma independiente y compare la cobertura pública de lugares en momentos de recolección específicos.
Colas de verificación
Arme una lista preseleccionada a partir de los campos públicos de identidad, contacto, calificación y ubicación para una revisión posterior o un proceso de detalle independiente.
Límites y política de datos públicos
Los resultados son registros públicos de un momento dado. La disponibilidad de la búsqueda y lo completo de los campos dependen de lo que la fuente exponga para la solicitud enviada.
- query y location son cadenas obligatorias y no vacías; location no se puede reemplazar por coordenadas.
- country, latitude, longitude y zoom_level son opcionales; la ejecución actual acepta latitude y longitude de forma independiente.
- zoom_level debe ser un entero de 0 a 21, y results_limit tiene un valor predeterminado de 100 y un rango aceptado de 1 a 2,000.
- results_limit es un máximo de recolección, mientras que el limit del GET de la tarea controla cada página de resultados almacenados que se devuelve.
- Los resultados públicos pueden omitir descripciones, categorías, datos de contacto, calificaciones, conteos de reseñas, URL o subcampos geográficos.
- Las identidades expuestas duplicadas se almacenan una sola vez por tarea, por lo que result_count puede ser menor que la cantidad de filas de la fuente observadas.
Preguntas frecuentes sobre la API de Google Maps
¿Qué es la API de Google Maps?
Las API de Google Maps buscan lugares públicos de forma asíncrona, resuelven URL conocidas de lugares y obtienen reseñas públicas como registros normalizados. Search acepta query y location, y devuelve registros PlaceItem con los campos disponibles de identidad, dirección, contacto, calificación, conteo de reseñas, URL y coordenadas.
¿Qué requiere Search?
Search requiere cadenas query y location no vacías. country, latitude, longitude, zoom_level y results_limit son opcionales.
¿En qué se diferencian la recolección y la paginación de la respuesta?
results_limit acota los registros que se recolectan para la búsqueda enviada. Después del éxito, el endpoint de tareas devuelve los registros almacenados en páginas controladas por sus propios parámetros limit y next_cursor.
¿Por qué los campos de un lugar pueden ser null?
Un resultado de búsqueda público puede no exponer todos los campos de contacto, calificación, reseñas, descripción, URL, dirección o coordenadas. El esquema normalizado conserva esos valores ausentes como null.
¿Cuánto cuestan los resultados de Google Maps Search?
Cada lugar almacenado cuesta 0.15 créditos. La estimación de la precarga usa results_limit, o 100 si se omite, y al completarse con éxito se liquida según la cantidad real de resultados almacenados.
Combine datos de varias plataformas para obtener información de negocio más completa
Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.
Google Play API
Obtenga detalles públicos de apps de Google Play, clasificaciones por categoría y reseñas a partir de URL conocidas de la tienda, como registros normalizados de apps y reseñas.
Amazon API
Busque productos públicos de Amazon y obtenga registros normalizados de detalles de productos, Best Sellers, reseñas, perfiles de vendedores y tiendas de creadores de los marketplaces compatibles.
Apple App Store API
Obtenga detalles públicos de apps de Apple App Store, clasificaciones por categoría y reseñas a partir de URL conocidas de la tienda, como registros normalizados de apps y reseñas.
SEO API
Consulte resultados orgánicos de Google en vivo, compare la demanda de palabras clave y la dificultad de posicionamiento, amplíe términos semilla, descubra las palabras clave y las páginas que impulsan la visibilidad de un sitio en las búsquedas, clasifique la intención de búsqueda y recopile resultados de Google News, Google Images, Google Autocomplete, Bing y YouTube. Todos los endpoints usan la misma clave de API de SocQ, el mismo flujo de tareas asíncronas y el mismo formato de resultados normalizado.
Telegram API
Lea canales públicos de Telegram a partir de sus enlaces t.me: perfiles de canal con suscriptores, publicaciones con vistas y reacciones, publicaciones sueltas, comentarios de grupos de discusión, canales similares y búsqueda en todo el historial.
Link in Bio API
Convierta el único enlace de la bio de Instagram, TikTok o YouTube de un creador en datos estructurados: nombre visible, bio, avatar, correo de contacto indicado, perfiles sociales vinculados y cada botón de la página con su título y destino.


