Get company details
Retrieve detailed information about a specific LinkedIn company page including full description, specialties, employee count, headquarters location, and industry classification.
/search/companies/detailsCode Examples
curl -X POST 'https://api.connectsafely.ai/linkedin/search/companies/details' \ -H 'Authorization: Bearer <your_api_key>' \ -H 'Content-Type: application/json' \ -d '{"companyId":"Acme Inc"}'Parameters
No parameters.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | No | LinkedIn account ID to use. If not provided, uses the default account. |
companyId | string | Yes | LinkedIn company ID from search results or company page URL |
Example
{
"companyId": "Acme Inc"
}Responses
| Status | Description |
|---|---|
| 200 | Company details retrieved successfully |
| 400 | Bad Request - Missing required companyId parameter |
| 401 | Unauthorized - Invalid or missing API key |
| 500 | Internal Server Error - Failed to get LinkedIn credentials or company details |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
company | object | Detailed company information |
200 Example
{
"success": true,
"company": {
"id": "1441",
"name": "Google",
"universalName": "google",
"tagline": null,
"description": "A problem isn't truly solved until it's solved for all...",
"websiteUrl": "https://goo.gle/3DLEokh",
"phone": null,
"companyType": "COMPANY",
"headquarters": {},
"employeeRange": {
"start": 10001,
"end": null
},
"staffCount": 334483,
"specialities": [
"search",
"ads",
"mobile",
"android",
"machine learning"
],
"logoUrl": "https://media.licdn.com/dms/image/.../google_logo",
"coverImageUrl": "https://media.licdn.com/dms/image/.../google_cover",
"linkedinUrl": "https://www.linkedin.com/company/google/",
"isActive": true,
"isVerified": false
}
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
error | object |
400 Example
{
"success": false,
"error": {
"issues": [
{
"code": "invalid_type",
"expected": "string",
"received": "undefined",
"path": [
"companyId"
],
"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 get company details",
"success": false
}Search LinkedIn companies
Search for companies on LinkedIn by keywords and filters. Filter by headquarters location, industry, company size, and type. Useful for lead generation, market research, and finding potential business partners. 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).
Search LinkedIn groups
Search for LinkedIn groups by keywords. Groups are communities where professionals discuss industry topics, share insights, and network. Filter by group size to find active communities. Rate Limit: 300 searches per account per month (resets on the 1st of each month).