Google Maps Places Enrich

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"
}
'

import requests

url = "https://api.edges.run/v1/flows/google-maps-places-enrich/run/async"

payload = {
    "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"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.edges.run/v1/flows/google-maps-places-enrich/run/async', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.edges.run/v1/flows/google-maps-places-enrich/run/async",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.edges.run/v1/flows/google-maps-places-enrich/run/async"

	payload := strings.NewReader("{\n  \"inputs\": [\n    {\n      \"google_maps_search_url\": \"<string>\",\n      \"custom_data\": {\n        \"meta\": \"<unknown>\"\n      }\n    }\n  ],\n  \"steps\": [],\n  \"parameters\": {\n    \"googlemaps-search-places\": {},\n    \"googlemaps-extract-place\": {}\n  },\n  \"identity_ids\": [\n    \"44444444-4444-4444-4444-444444444444\"\n  ],\n  \"identity_mode\": \"direct\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.edges.run/v1/flows/google-maps-places-enrich/run/async")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"inputs\": [\n    {\n      \"google_maps_search_url\": \"<string>\",\n      \"custom_data\": {\n        \"meta\": \"<unknown>\"\n      }\n    }\n  ],\n  \"steps\": [],\n  \"parameters\": {\n    \"googlemaps-search-places\": {},\n    \"googlemaps-extract-place\": {}\n  },\n  \"identity_ids\": [\n    \"44444444-4444-4444-4444-444444444444\"\n  ],\n  \"identity_mode\": \"direct\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.edges.run/v1/flows/google-maps-places-enrich/run/async")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"inputs\": [\n    {\n      \"google_maps_search_url\": \"<string>\",\n      \"custom_data\": {\n        \"meta\": \"<unknown>\"\n      }\n    }\n  ],\n  \"steps\": [],\n  \"parameters\": {\n    \"googlemaps-search-places\": {},\n    \"googlemaps-extract-place\": {}\n  },\n  \"identity_ids\": [\n    \"44444444-4444-4444-4444-444444444444\"\n  ],\n  \"identity_mode\": \"direct\"\n}"

response = http.request(request)
puts response.read_body

{
  "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow": {
    "uid": "<string>",
    "metadata": {
      "account_rotation": true
    }
  }
}

{
  "error_label": "<string>",
  "error_scope": "input",
  "error_ref": "ERR-12345",
  "message": "<string>",
  "status_code": 123,
  "params": {},
  "data": {}
}

{
  "error_label": "<string>",
  "error_scope": "input",
  "error_ref": "ERR-12345",
  "message": "<string>",
  "status_code": 123,
  "params": {},
  "data": {}
}

{
  "error_label": "<string>",
  "error_scope": "input",
  "error_ref": "ERR-12345",
  "message": "<string>",
  "status_code": 123,
  "params": {},
  "data": {}
}

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"
}
'

import requests

url = "https://api.edges.run/v1/flows/google-maps-places-enrich/run/async"

payload = {
    "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"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.edges.run/v1/flows/google-maps-places-enrich/run/async', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.edges.run/v1/flows/google-maps-places-enrich/run/async",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.edges.run/v1/flows/google-maps-places-enrich/run/async"

	payload := strings.NewReader("{\n  \"inputs\": [\n    {\n      \"google_maps_search_url\": \"<string>\",\n      \"custom_data\": {\n        \"meta\": \"<unknown>\"\n      }\n    }\n  ],\n  \"steps\": [],\n  \"parameters\": {\n    \"googlemaps-search-places\": {},\n    \"googlemaps-extract-place\": {}\n  },\n  \"identity_ids\": [\n    \"44444444-4444-4444-4444-444444444444\"\n  ],\n  \"identity_mode\": \"direct\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.edges.run/v1/flows/google-maps-places-enrich/run/async")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"inputs\": [\n    {\n      \"google_maps_search_url\": \"<string>\",\n      \"custom_data\": {\n        \"meta\": \"<unknown>\"\n      }\n    }\n  ],\n  \"steps\": [],\n  \"parameters\": {\n    \"googlemaps-search-places\": {},\n    \"googlemaps-extract-place\": {}\n  },\n  \"identity_ids\": [\n    \"44444444-4444-4444-4444-444444444444\"\n  ],\n  \"identity_mode\": \"direct\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.edges.run/v1/flows/google-maps-places-enrich/run/async")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"inputs\": [\n    {\n      \"google_maps_search_url\": \"<string>\",\n      \"custom_data\": {\n        \"meta\": \"<unknown>\"\n      }\n    }\n  ],\n  \"steps\": [],\n  \"parameters\": {\n    \"googlemaps-search-places\": {},\n    \"googlemaps-extract-place\": {}\n  },\n  \"identity_ids\": [\n    \"44444444-4444-4444-4444-444444444444\"\n  ],\n  \"identity_mode\": \"direct\"\n}"

response = http.request(request)
puts response.read_body

{
  "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow": {
    "uid": "<string>",
    "metadata": {
      "account_rotation": true
    }
  }
}

{
  "error_label": "<string>",
  "error_scope": "input",
  "error_ref": "ERR-12345",
  "message": "<string>",
  "status_code": 123,
  "params": {},
  "data": {}
}

{
  "error_label": "<string>",
  "error_scope": "input",
  "error_ref": "ERR-12345",
  "message": "<string>",
  "status_code": 123,
  "params": {},
  "data": {}
}

{
  "error_label": "<string>",
  "error_scope": "input",
  "error_ref": "ERR-12345",
  "message": "<string>",
  "status_code": 123,
  "params": {},
  "data": {}
}

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:

Search Google Maps (required): Searches Google Maps for places matching your search query
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).

Custom Data

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:

Basic place search

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 '{
  "inputs": [
    {
      "google_maps_search_url": "https://www.google.com/maps/search/coffee+shops+near+San+Francisco"
    }
  ]
}'

Search with country and language settings

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"
    }
  ]
}'

With webhook callback

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:

Field	Description
`place_name`	Name of the business/place
`address`	Full address
`phone`	Phone number
`website`	Website URL
`rating`	Average rating (1-5)
`number_reviews`	Total number of reviews
`category`	Business category
`opening_hours`	Opening hours schedule
`description`	Business description
`google_maps_place_url`	Direct link to Google Maps
`google_maps_place_id`	Unique Google Maps place ID
`coordinates_latitude`	Latitude coordinate
`coordinates_longitude`	Longitude 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

Show child attributes

steps

enum<string>[]

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

parameters

object

Show child attributes

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

Show child attributes

Callbacks

POST

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

Body

application/json

flow_run

object

Show child attributes

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.

Show child attributes

results_count

integer

Number of results in the current callback

results

object[]

Results of the current callback

Show child attributes

Response

200

Callback successfully processed

Response

Successful response

uid

string<uuid>

workflow

object

Show child attributes

API documentation

Runs & Schedules

Flows Presets

Single Actions

Google Maps Places Enrich

Flow Steps

Output Fields

Authorizations

Body

Callbacks

Body

Response

Response

​Flow Steps

​Output Fields

Authorizations

Body

Callbacks

Body

Response

Response

Flow Steps

Output Fields