Las calificaciones de reseñas de Google son una poderosa señal de calificación de clientes potenciales. Las empresas con calificaciones bajas a menudo necesitan ayuda con la gestión de la reputación, el servicio al cliente o la calidad del producto. Las empresas con calificaciones altas y muchas reseñas son fuertes candidatos para asociarse. Este tutorial muestra cómo utilizar la API de Scavio para buscar empresas locales, filtrarlas por calificación y recuento de reseñas, y crear una lista de clientes potenciales calificados. Creará un canal que se dirija a empresas en rangos de calificación específicos y las exporte para su divulgación.
Requisitos previos
- Python 3.8+ instalado
- solicita biblioteca instalada
- Una clave API de Scavio de scavio.dev
- Una industria y una ubicación objetivo
Guia paso a paso
Paso 1: Buscar empresas por categoría
Consulta Google Maps para empresas en tu categoría y ubicación objetivo.
import os, requests, json
API_KEY = os.environ["SCAVIO_API_KEY"]
def search_businesses(category, location):
resp = requests.post("https://api.scavio.dev/api/v1/search",
headers={"x-api-key": API_KEY},
json={"platform": "google", "query": f"{category} in {location}", "type": "maps"})
return resp.json().get("local_results", [])
businesses = search_businesses("dentists", "San Francisco")
print(f"Found {len(businesses)} businesses")Paso 2: Filtrar por rango de calificación
Segmente las empresas en categorías de clientes potenciales según sus calificaciones de reseñas.
def filter_by_rating(businesses, min_r, max_r, min_reviews=5):
return [
b for b in businesses
if min_r <= float(b.get("rating", 0)) <= max_r
and int(b.get("reviews", 0)) >= min_reviews
]
low_rated = filter_by_rating(businesses, 1.0, 3.5)
high_rated = filter_by_rating(businesses, 4.5, 5.0, min_reviews=50)
print(f"Low rated leads: {len(low_rated)}")
print(f"High rated prospects: {len(high_rated)}")Paso 3: Enriquezca los clientes potenciales con datos adicionales
Busque el sitio web de cada cliente potencial para encontrar información de contacto y contexto.
def enrich_lead(business):
name = business.get("title", "")
resp = requests.post("https://api.scavio.dev/api/v1/search",
headers={"x-api-key": API_KEY},
json={"platform": "google", "query": f"{name} contact"})
results = resp.json().get("organic_results", [])[:2]
return {
"name": name,
"rating": business.get("rating", ""),
"reviews": business.get("reviews", 0),
"address": business.get("address", ""),
"phone": business.get("phone", ""),
"website": results[0].get("link", "") if results else "",
}Paso 4: Exportar clientes potenciales calificados
Guarde los clientes potenciales filtrados y enriquecidos en un archivo JSON para su CRM o herramienta de divulgación.
import csv
def export_leads(leads, filename):
enriched = [enrich_lead(b) for b in leads]
with open(filename, "w", newline="") as f:
w = csv.DictWriter(f, fieldnames=enriched[0].keys())
w.writeheader()
w.writerows(enriched)
print(f"Exported {len(enriched)} leads to {filename}")
export_leads(low_rated[:10], "low_rated_leads.csv")Ejemplo en Python
import os, requests
API_KEY = os.environ["SCAVIO_API_KEY"]
resp = requests.post("https://api.scavio.dev/api/v1/search",
headers={"x-api-key": API_KEY},
json={"platform": "google", "query": "dentists in San Francisco", "type": "maps"})
for b in resp.json().get("local_results", []):
r = float(b.get("rating", 0))
if r <= 3.5 and int(b.get("reviews", 0)) >= 5:
print(f"{b['title']} - {r} stars ({b.get('reviews')} reviews)")Ejemplo en JavaScript
const H = {"x-api-key": process.env.SCAVIO_API_KEY, "Content-Type": "application/json"};
const r = await fetch("https://api.scavio.dev/api/v1/search", {
method: "POST", headers: H,
body: JSON.stringify({platform: "google", query: "dentists in San Francisco", type: "maps"})
});
const data = await r.json();
(data.local_results || []).filter(b => parseFloat(b.rating||0) <= 3.5)
.forEach(b => console.log(b.title, b.rating, b.reviews));Salida esperada
A qualified lead list of businesses filtered by Google review rating, enriched with contact data, and exported as CSV for outreach campaigns.