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 |
Search Companies
Search LinkedIn companies with advanced filters via API. Find target accounts by industry, size, location, and keywords for B2B prospecting.
Search Groups
Search LinkedIn groups via API to find communities by keywords and industry. Perfect for building targeted engagement and lead generation workflows.