Search geo locations
Search for LinkedIn geo location IDs by place name. Use this endpoint to find location IDs that can be used as filters in other search endpoints (jobs, companies, people). Returns matching cities, regions, and countries. Rate limit: no per-account search quota is enforced on this lookup — only the general 30-calls-per-minute velocity limit. Resolve an id once and reuse it rather than looking it up on every request.
/search/geoCode Examples
curl -X POST 'https://api.connectsafely.ai/linkedin/search/geo' \ -H 'Authorization: Bearer <your_api_key>' \ -H 'Content-Type: application/json' \ -d '{"keywords":"software engineer"}'Search for LinkedIn geo location IDs by place name. Use this endpoint to find location IDs that can be used as filters in other search endpoints (jobs, companies, people). Returns matching cities, regions, and countries.
Rate limit: no per-account search quota is enforced on this lookup — only the general 30-calls-per-minute velocity limit. Resolve an id once and reuse it rather than looking it up on every request.
Parameters
No parameters.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | No | LinkedIn account ID to use for the search. If not provided, uses the default account. |
keywords | string | Yes | Location name to search for (e.g., "San Francisco", "United States", "London") |
countryCodes | array | No | Limit results to specific countries using ISO country codes (e.g., ["US", "GB"]) |
Example
{
"keywords": "software engineer"
}Responses
| Status | Description |
|---|---|
| 200 | Geo locations retrieved successfully |
| 400 | Bad Request - Missing required keywords parameter |
| 401 | Unauthorized - Invalid or missing API key |
| 500 | Internal Server Error - Failed to get LinkedIn credentials or search failed |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
locations | array | |
count | number | Number of locations returned |
200 Example
{
"success": true,
"locations": [
{
"name": "San Francisco Bay Area",
"geoId": "90000084",
"countryCode": "US"
},
{
"name": "San Francisco, California, United States",
"geoId": "102277331",
"countryCode": "US"
}
],
"count": 2
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
error | object |
400 Example
{
"success": false,
"error": {
"issues": [
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"keywords"
],
"message": "Required"
}
],
"name": "ZodError"
}
}401 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
401 Example
{
"error": "Unauthorized - Invalid credentials"
}500 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
500 Example
{
"error": "Failed to search geo locations",
"success": false
}Search LinkedIn posts (V2 - with auto-pagination)
Search for LinkedIn posts with enhanced filtering options and automatic pagination. Automatically handles LinkedIn pagination internally - specify the total count you want (max 50) and the API will fetch multiple pages as needed (max 10 pages, 10 results per page). Supports filtering by date, content type, author, and more. Important: This V2 endpoint uses LinkedIn's newer search, which is rolling out gradually by region. If this endpoint does not return results for your account, use the V1 `/search/posts` endpoint instead. Rate limit: 1,000 search calls per account per day (resets at midnight UTC), and 30 calls per minute. One request counts as one call regardless of `count`.
LinkedIn Analytics API
Access LinkedIn analytics via API including profile visitors, creator analytics, engagement metrics, and weekly performance data. Track your content strategy results.