Migrate from Apify Google Maps Scraper to <1s Synchronous REST JSON — Save 40%–60%+.

# BEFORE (Async container job: 15–45s container boot + dataset polling + CU overhead)
# run = ApifyClient(TOKEN).actor("compass/crawler-google-places").call(run_input={
#     "searchStringsArray": ["coffee in Austin"],
#     "maxCrawledPlacesPerSearch": 20,
#     "scrapeContacts": True,
# })
# items = list(client.dataset(run["defaultDatasetId"]).iterate_items())

# AFTER (GoogleMapsAPI.io: <1s synchronous HTTP GET — 0 container boot fees)
import os
import requests

API_KEY = os.environ["GOOGLEMAPS_API_KEY"]  # gm_live_... (12,000 free credits on signup)
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Search Google Maps places synchronously (/v1/places/search)
places_resp = requests.get(
    "https://api.googlemapsapi.io/v1/places/search",
    params={"q": "coffee in Austin", "limit": 20, "hl": "en", "gl": "us"},
    headers=HEADERS,
    timeout=15,
)
places_resp.raise_for_status()
places = places_resp.json()["data"]

# 2. Optional: Full details, customer reviews, or live domain B2B email enrichment
first = places[0]
reviews = requests.get(
    "https://api.googlemapsapi.io/v1/places/reviews",
    params={"place_id": first["place_id"], "sort": "newest", "limit": 10},
    headers=HEADERS,
    timeout=15,
).json()["data"]

if first.get("domain"):
    contacts = requests.get(
        "https://api.googlemapsapi.io/v1/leads/enrich",
        params={"domain": first["domain"]},
        headers=HEADERS,
        timeout=15,
    ).json()["data"]
    print(first["name"], first["phone"], contacts.get("emails", []))

// BEFORE: await apifyClient.actor("...").call({ searchStringsArray, maxReviews, scrapeContacts: true })
// AFTER: Native fetch() — zero SDK dependencies, <1s response for Clay / n8n / Next.js / BullMQ workers

const API_KEY = process.env.GOOGLEMAPS_API_KEY!;
const headers = { Authorization: `Bearer ${API_KEY}` };

// 1. Place Search -> /v1/places/search
const searchRes = await fetch(
  "https://api.googlemapsapi.io/v1/places/search?q=" +
    encodeURIComponent("coffee in Austin") +
    "&limit=20&hl=en&gl=us",
  { headers },
);
const { data: places } = await searchRes.json();

// 2. Place Details + Verified Reviews + B2B Domain Contacts in parallel
const lead = places[0];
const [detailsRes, reviewsRes, enrichRes] = await Promise.all([
  fetch(`https://api.googlemapsapi.io/v1/places/details?place_id=${encodeURIComponent(lead.place_id)}`, { headers }),
  fetch(`https://api.googlemapsapi.io/v1/places/reviews?place_id=${encodeURIComponent(lead.place_id)}&sort=newest&limit=10`, { headers }),
  lead.domain
    ? fetch(`https://api.googlemapsapi.io/v1/leads/enrich?domain=${encodeURIComponent(lead.domain)}`, { headers })
    : Promise.resolve(null),
]);

const details = (await detailsRes.json()).data;
const reviews = (await reviewsRes.json()).data;
const contacts = enrichRes ? (await enrichRes.json()).data : null;
console.log({ name: details.name, rating: details.rating, reviews: reviews.length, contacts });

# 1. Search local businesses (<1s sync JSON — 5 Credits / place returned)
curl -sS "https://api.googlemapsapi.io/v1/places/search?q=coffee+in+Austin&limit=2&hl=en&gl=us" \
  -H "Authorization: Bearer gm_live_YOUR_API_KEY"

# 2. Fetch full Place Profile by place_id (20 Credits)
curl -sS "https://api.googlemapsapi.io/v1/places/details?place_id=ChIJdeM0zsi1RIYRp6f261L65h0" \
  -H "Authorization: Bearer gm_live_YOUR_API_KEY"

# 3. Stream verified customer reviews sorted by newest (2 Credits / review)
curl -sS "https://api.googlemapsapi.io/v1/places/reviews?place_id=ChIJdeM0zsi1RIYRp6f261L65h0&sort=newest&limit=10" \
  -H "Authorization: Bearer gm_live_YOUR_API_KEY"

# 4. Extract B2B emails & 8 social profiles from business domain (0 Credits if none found!)
curl -sS "https://api.googlemapsapi.io/v1/leads/enrich?domain=houndstoothcoffee.com" \
  -H "Authorization: Bearer gm_live_YOUR_API_KEY"

{
  "ok": true,
  "endpoint": "/v1/places/search",
  "meta": {
    "request_id": "req_gm_sync_mig_91f2a",
    "credits_used": 10,
    "took_ms": 21,
    "cache_hit": true
  },
  "data": [
    {
      "place_id": "ChIJdeM0zsi1RIYRp6f261L65h0",
      "cid": "2154572145967638439",
      "name": "Black Cat Coffee",
      "category": "Coffee shop",
      "rating": 4.9,
      "review_count": 318,
      "phone": "+15125550194",
      "website": "https://houndstoothcoffee.com",
      "domain": "houndstoothcoffee.com",
      "address": "401 Congress Ave, Austin, TX 78701",
      "city": "Austin",
      "state": "TX",
      "postal_code": "78701",
      "country_code": "US",
      "latitude": 30.266624,
      "longitude": -97.742951,
      "is_open_now": true
    }
  ]
}