Docs menu

Crawlora Docs

Build a Google Maps Lead Research Workflow

Collect local business search results, enrich selected places, deduplicate records, and export compliant business research.

Overview

Collect local business search results, enrich selected places, deduplicate records, and export compliant business research.

What you will build

  • Define category and location
  • Search places
  • Enrich selected places
  • Deduplicate
  • Export to CRM or database
  • Review for compliant use

APIs used

Only endpoints that exist in the generated endpoint metadata are linked here. Missing optional endpoints are intentionally omitted.

POSTGoogle MapapiKey5 credits/request

Google Maps search API

/google/map/search

Returns results from Google Maps based on search options. Rate limit is enforced at 1 request per second.

GETGoogle MapapiKey5 credits/request

Google Maps place details API

/google/map/place/{place_id}

Returns detailed information for a specified place_id. Rate limit is enforced at 1 request per second.

Data model

FieldNotes
queryWorkflow field; map to exact endpoint response fields from endpoint docs.
locationWorkflow field; map to exact endpoint response fields from endpoint docs.
place_idWorkflow field; map to exact endpoint response fields from endpoint docs.
nameWorkflow field; map to exact endpoint response fields from endpoint docs.
addressWorkflow field; map to exact endpoint response fields from endpoint docs.
categoryWorkflow field; map to exact endpoint response fields from endpoint docs.
ratingWorkflow field; map to exact endpoint response fields from endpoint docs.
phoneWorkflow field; map to exact endpoint response fields from endpoint docs.
websiteWorkflow field; map to exact endpoint response fields from endpoint docs.
checked_atWorkflow field; map to exact endpoint response fields from endpoint docs.

Step-by-step workflow

  1. 1.Define category and location
  2. 2.Search places
  3. 3.Enrich selected places
  4. 4.Deduplicate
  5. 5.Export to CRM or database
  6. 6.Review for compliant use

Example request

This example uses the real Google Maps search API endpoint. Exact request fields come from the endpoint metadata.

Recipe request

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X POST "https://api.crawlora.net/api/v1/google/map/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us","keyword":"hotel san francisco","language":"en"}'

Example response

Use endpoint detail pages for exact response schemas. This recipe does not invent response fields.

Generated example response

{
  "code": 200,
  "msg": "OK",
  "data": [
    {
      "url": "https://www.google.com/maps/place/?q=place_id:ChIJs3cv0KuvEmsRHcXYwNJ6GU0",
      "name": "Primi Italian",
      "place_id": "ChIJs3cv0KuvEmsRHcXYwNJ6GU0",
      "category": [
        "italian_restaurant"
      ],
      "address": "168 Clarence St, Sydney NSW 2000, Australia",
      "latitude": -33.8701437,
      "longitude": 151.2056158
    }
  ]
}

Storage/output suggestion

Use place_id as the stable dedupe key when available and keep snapshot timestamps for repeated market mapping.

Error handling

  • Validate required inputs before calling Crawlora
  • Retry 429 and temporary 5xx responses with capped backoff
  • Log endpoint, input, timestamp, and request ID when present
  • Treat empty results as a state your application can handle
  • Open /docs/errors for production retry guidance

Rate-limit and credit planning

Estimate usage by multiplying requests by endpoint credit cost. The table below only shows real credit costs available from the billing constants.

EndpointCredit costDocs
Google Maps search API5 credits/request/docs/Google%20Map/google-map-search
Google Maps place details API5 credits/request/docs/Google%20Map/google-map-place

Production checklist

  • Keep API keys server-side
  • Use request timeouts
  • Back off on rate limits
  • Store raw responses or source IDs for auditability
  • Monitor credits and failures
  • Avoid unnecessary refreshes
  • Review responsible-use requirements

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

Related APIs and pages

Build this workflow with real endpoint docs

Use this recipe for workflow shape, then rely on endpoint reference pages for exact paths, request schemas, response schemas, and credit costs.