Get Location Id

This endpoint retrieves the locationId and related details for a given location name. It helps users search for geographic locations (e.g., cities or regions) and fetch the corresponding identifiers required for targeting in Google Ads campaigns.

POST /gads/get_location_id

Get Location Id

cURL

curl --request POST \
  --url https://public.plai.io/gads/get_location_id \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "location": "<string>"
}
'

200

{
  "success": true,
  "results": {
    "success": true,
    "locationId": "<string>",
    "error": "<string>"
  }
}

Request Body

location · string · required

Name of the location to search for its corresponding locationId.

Example: "Grand Canyon, Arizona"

Response

success · boolean

Indicates that the HTTP response was successful (status code 200 OK).

results · object

Show Results Object

success · boolean

Indicates whether the specific operation or API action was successful.

locationId · string

A locationId is a unique identifier assigned by Google Ads to represent a specific geographic location (such as a city, state, country, or region).

This ID is used in campaign targeting to define where your ads should appear.

Example: "21167" represents New York, USA.

error · string

Error string if something went wrong