Find Geocode by Location

GET /find-geocode-by-location

Find LinkedIn geocode IDs by location name. Use this to get geo codes for search filters.

Pricing

1 credit per call.

Parameters

Parameter	Type	Required	Description
location	string	Yes	Location name to search (e.g., San Francisco, United States, California)

Example Request

cURL

curl --request GET \
  --url 'https://api.infoplug.io/find-geocode-by-location?location=San%20Francisco' \
  --header 'X-INFOPLUG-API-KEY: YOUR_API_KEY'

Python

import requests

url = "https://api.infoplug.io/find-geocode-by-location"
params = {
    "location": "San Francisco"
}
headers = {
    "X-INFOPLUG-API-KEY": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

Node.js

const response = await fetch(
  'https://api.infoplug.io/find-geocode-by-location?location=San%20Francisco',
  {
    headers: {
      'X-INFOPLUG-API-KEY': 'YOUR_API_KEY'
    }
  }
);
const data = await response.json();
console.log(data);

Example Response

200 OK

{
  "data": {
    "message": "ok",
    "data": [
      {
        "geo_id": "102277331",
        "name": "San Francisco, California, United States",
        "type": "CITY"
      },
      {
        "geo_id": "90000084",
        "name": "San Francisco Bay Area",
        "type": "METRO_AREA"
      },
      {
        "geo_id": "102095887",
        "name": "California, United States",
        "type": "ADMIN_DIVISION"
      }
    ]
  }
}

400 Bad Request

{
  "message": "invalid_parameter",
  "parameter": "location",
  "details": "Location is required"
}

401 Unauthorized

{
  "message": "unauthorized",
  "details": "Invalid or missing API key"
}

500 Timeout

{
  "message": "error",
  "error": "Request timed out waiting for geocode results"
}

Usage

Use the geo_id values from this endpoint in search filters:

• Search Leads - geo_codes parameter
• Search Companies - headquarters_location parameter
• Search Jobs - geo_code parameter

Related

• Supported Locations - Get list of all supported countries
• How to Geocode - Tutorial on using geocodes