Search LinkedIn companies

Search for companies on LinkedIn by keywords and filters. Filter by headquarters location, industry, and company size. Useful for lead generation, market research, and finding potential business partners. Handles LinkedIn's page-based pagination internally: ask for the total `count` you want and the API walks as many ~10-result pages as it takes (max 11). `filters.companyType` and `filters.followedCompanies` are still accepted but no longer narrow the result set — LinkedIn's current company search offers no such facet. Sales Navigator Support: Pass a Sales Navigator company search URL in the `url` parameter to search using Sales Navigator filters (revenue, employees, etc.). Requires Sales Navigator license on the LinkedIn account. Rate Limit: 300 searches per account per month (resets on the 1st of each month). Each page walked counts as one search, so a `count` of 25 spends 3.

POST/search/companies

Authentication requiredSearch

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/search/companies' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"accountId":"acc_12345","keywords":"","url":"https://linkedin.com/in/example","count":25,"start":0,"filters":{"locationId":null,"industry":["Technology"],"companySize":["Acme Inc"],"companyType":["Acme Inc"],"followedCompanies":false}}'

Handles LinkedIn's page-based pagination internally: ask for the total count you want and the API walks as many ~10-result pages as it takes (max 11).

filters.companyType and filters.followedCompanies are still accepted but no longer narrow the result set — LinkedIn's current company search offers no such facet.

Sales Navigator Support: Pass a Sales Navigator company search URL in the url parameter to search using Sales Navigator filters (revenue, employees, etc.). Requires Sales Navigator license on the LinkedIn account.

Rate Limit: 300 searches per account per month (resets on the 1st of each month). Each page walked counts as one search, so a count of 25 spends 3.

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	No	Search keywords for company name or description (used for regular LinkedIn search)
`url`	string	No	Sales Navigator company search URL (e.g., https://www.linkedin.com/sales/search/company?query=...). Requires Sales Navigator license. When provided, uses Sales Navigator API with advanced filters like revenue and employee count.
`count`	number	No	Total number of results to return. Pages are walked internally to reach it — see the rate-limit note.
`start`	number	No	Row offset to start from (0-indexed). Need not land on a page boundary.
`filters`	object	No	Optional filters to narrow down search results

Example

{
  "accountId": "acc_12345",
  "keywords": "",
  "url": "https://linkedin.com/in/example",
  "count": 25,
  "start": 0,
  "filters": {
    "locationId": null,
    "industry": [
      "Technology"
    ],
    "companySize": [
      "Acme Inc"
    ],
    "companyType": [
      "Acme Inc"
    ],
    "followedCompanies": false
  }
}

Responses

Status	Description
200	Companies retrieved successfully
400	Bad Request - Invalid request parameters
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
`companies`	array
`pagination`	any
`hasMore`	boolean	Whether more results are available

200 Example

{
  "success": true,
  "companies": [
    {
      "companyId": "1441",
      "name": "Google",
      "universalName": "google",
      "headline": "Software Development • Mountain View, CA",
      "description": "A problem isn't truly solved until it's solved for all.",
      "logoUrl": "https://media.licdn.com/dms/image/.../google_logo",
      "industry": "Software Development",
      "followerCount": 41000000,
      "companyUrl": "https://www.linkedin.com/company/google/",
      "location": "Mountain View, CA"
    },
    {
      "companyId": "1594050",
      "name": "Google DeepMind",
      "universalName": "googledeepmind",
      "headline": "Research Services • London, London",
      "description": "We're committed to solving intelligence.",
      "logoUrl": "https://media.licdn.com/dms/image/.../googledeepmind_logo",
      "industry": "Research Services",
      "followerCount": 1000000,
      "companyUrl": "https://www.linkedin.com/company/googledeepmind/",
      "location": "London, London"
    }
  ],
  "pagination": {
    "count": 25,
    "start": 0
  },
  "hasMore": true
}

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 companies",
  "success": false
}

Code Examples

On this page