Search Geo Locations
Search for geographic locations on LinkedIn for use in filters. Returns location IDs that can be used in other search endpoints.
POST
/linkedin/search/geoSearch Geo Locations
Search for geographic locations on LinkedIn for use in filters. Returns location IDs that can be used in other search endpoints.
Authentication requiredLinkedIn Search
Code Examples
curl -X POST 'https://api.connectsafely.ai/linkedin/search/geo' \ -H 'Authorization: Bearer <your_api_key>' \ -H 'Content-Type: application/json' \ -d '{"keywords":"San Francisco"}'Parameters
No parameters.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | No | LinkedIn account ID (uses default if not provided) |
keywords | string | Yes | Location search keywords (e.g., city, state, country name) |
countryCodes | string[] | No | Filter results by country codes (e.g., ["US", "CA"]) |
Example
{
"keywords": "San Francisco"
}Example with Country Filter
{
"keywords": "Toronto",
"countryCodes": ["CA"]
}Responses
| Status | Description |
|---|---|
| 200 | Successful response |
200 Example
{
"success": true,
"locations": [
{
"id": "102277331",
"name": "San Francisco, California, United States",
"type": "CITY"
},
{
"id": "102571732",
"name": "San Francisco Bay Area",
"type": "REGION"
},
{
"id": "103167585",
"name": "San Francisco County, California, United States",
"type": "ADMIN_DIVISION_2"
}
],
"count": 3
}Usage Notes
The location IDs returned by this endpoint can be used in other search endpoints:
- Jobs Search: Use the
idasgeoUrnorlocationIdin the filters - People Search: Use the
idasgeoUrnorlocationIdin the filters - Companies Search: Use the
idasgeoUrnorlocationIdin the filters
Location Types
| Type | Description |
|---|---|
COUNTRY | Country-level location |
REGION | Regional area (e.g., Bay Area, Metro Area) |
CITY | City-level location |
ADMIN_DIVISION_1 | State/Province level |
ADMIN_DIVISION_2 | County/District level |