Skip to main content
POST
/
flows
/
google-maps-places-enrich
/
run
/
async
Run google-maps-places-enrich flow asynchronously
curl --request POST \
  --url https://api.edges.run/v1/flows/google-maps-places-enrich/run/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "inputs": [
    {
      "google_maps_search_url": "<string>",
      "custom_data": {
        "meta": "<unknown>"
      }
    }
  ],
  "steps": [],
  "parameters": {
    "googlemaps-search-places": {},
    "googlemaps-extract-place": {}
  },
  "identity_ids": [
    "44444444-4444-4444-4444-444444444444"
  ],
  "identity_mode": "direct"
}
'
{
  "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow": {
    "uid": "<string>",
    "metadata": {
      "account_rotation": true
    }
  }
}
The Google Maps Places Enrich flow searches Google Maps for businesses and places, then extracts detailed information including contact details, reviews, and location data. This flow is ideal for local business discovery, market research, and lead generation.

​
Flow Steps

The flow executes steps in the following order:
  1. Search Google Maps (required): Searches Google Maps for places matching your search query
  2. Extract Place Details (optional): Extracts detailed information for each place found
You can customize the search by specifying country and language parameters to get location-relevant results. Use the max_results parameter to control how many places to extract (up to 1,000).
Each item in the inputs array can include an optional custom_data object. The only valid key inside custom_data is meta. Use meta to attach a free-form object (e.g. your own IDs, tags, or context) that will be passed through and available in the flow output.Example:
"inputs": [
  {
    ...
    "custom_data": {
      "meta": {
        "foo": "bar",
        "crm_id": 1234
      }
    }
  }
]
We currently require meta as a workaround to ship this capability; a more solid implementation will follow soon without breaking changes.
Examples: 
curl --request POST \
  --url https://api.edges.run/v1/flows/google-maps-places-enrich/run/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <your-api-key>' \
  --data '{
  "parameters": {
    "googlemaps-search-places": {
      "country": "FR",
      "language": "fr",
      "max_results": 200
    },
    "googlemaps-extract-place": {
      "country": "FR",
      "language": "fr"
    }
  },
  "inputs": [
    {
      "google_maps_search_url": "https://www.google.fr/maps/search/restaurants+paris"
    }
  ]
}'

curl --request POST \
  --url https://api.edges.run/v1/flows/google-maps-places-enrich/run/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <your-api-key>' \
  --data '{
  "parameters": {
    "googlemaps-search-places": {
      "max_results": 500
    }
  },
  "inputs": [
    {
      "google_maps_search_url": "https://www.google.com/maps/search/gyms+near+New+York"
    }
  ],
  "callback": {
    "url": "https://your-app.com/webhook/flow-results",
    "headers": {
      "Authorization": "Bearer your-webhook-token"
    }
  }
}'

​
Output Fields

The flow returns detailed place information including:
FieldDescription
place_nameName of the business/place
addressFull address
phonePhone number
websiteWebsite URL
ratingAverage rating (1-5)
number_reviewsTotal number of reviews
categoryBusiness category
opening_hoursOpening hours schedule
descriptionBusiness description
google_maps_place_urlDirect link to Google Maps
google_maps_place_idUnique Google Maps place ID
coordinates_latitudeLatitude coordinate
coordinates_longitudeLongitude coordinate
Instead of polling for results, you can use webhooks to receive automatic notifications when this flow completes. Learn more about webhook payloads and handling.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
inputs
object[]
required
Required array length: 1 - 1000 elements
​
steps
enum<string>[]

Optional list of step to run. If not provided, only the required steps will be run.

​
parameters
object
​
identity_ids
string<uuid>[] | null

An array of Identity UUIDs linked to identities (e.g. LinkedIn) used to execute the Action. You must provide at least one valid UID with access to the integration. Do not use account_uid values — only user_uid is supported.

Example:
["44444444-4444-4444-4444-444444444444"]
​
identity_mode
enum<string> | null
default:direct

If "auto", the Action will use any identities from the current workspace (unless you have provided a list of identity_ids). "managed" will use the Edges pool of identities for an extra credit cost

Available options:
direct,
auto,
managed
​
callback
object

Callbacks

POST
{$request.body#/callback/url}onSave

Body

application/json
​
flow_run
object
​
error
APIError · object

Represents an error returned by the API. This schema defines the standard structure of error messages to ensure consistent error handling across the application.

​
results_count
integer

Number of results in the current callback

​
results
object[]

Results of the current callback

Response

200

Callback successfully processed

Response

Successful response

Successful response

​
uid
string<uuid>
​
workflow
object