> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn Company Search

> Search LinkedIn for companies by keyword, industry, location, and size, returning name, profile URL, and employee count

`$3.5 / 1k companies`

Search LinkedIn for companies by keyword, industry, location, and size, returning name, profile URL, and employee count

## Endpoint

`POST /api/v1/agents/linkedin/company-search/run`

## Parameters

<ParamField body="query" type="string" required>
  **Text** · Keywords to find LinkedIn companies (e.g. 'fintech startup').
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Companies to return. Use 0 for all.
</ParamField>

<ParamField body="locations" type="array">
  **List** · Filter to companies in these locations (e.g. 'San Francisco'). One per line.
</ParamField>

<ParamField body="companySize" type="array">
  **Multi-select** · Filter to companies in this employee-count band.

  <Accordion title="Show all 9 options">
    `A`, `B`, `C`, `D`, `E`, `F`, `G`, `H`, `I`

    *Legend: `A` = Self-employed (1), `B` = 2-10, `C` = 11-50, `D` = 51-200, `E` = 201-500, `F` = 501-1000, `G` = 1001-5000, `H` = 5001-10000, `I` = 10001+*

    [View all 9 as a structured list →](/agents/linkedin/company-search/values#companysize)
  </Accordion>
</ParamField>

<ParamField body="industries" type="array">
  **Multi-select** · Filter to companies in this industry.

  [View all 434 options →](/agents/linkedin/company-search/values#industries)
</ParamField>

## Response columns

| Field                     | Display name              | Type    |
| ------------------------- | ------------------------- | ------- |
| `linkedinUrl`             | LinkedIn URL              | url     |
| `companyName`             | Company Name              | text    |
| `tagline`                 | Tagline                   | text    |
| `description`             | Description               | text    |
| `website`                 | Website                   | url     |
| `logo`                    | Logo                      | url     |
| `employees`               | Employees                 | number  |
| `employeeRangeMin`        | Employee Range Min        | number  |
| `employeeRangeMax`        | Employee Range Max        | number  |
| `followers`               | Followers                 | number  |
| `founded`                 | Founded                   | number  |
| `specialties`             | Specialties               | array   |
| `ctaLink`                 | CTA Link                  | url     |
| `jobsUrl`                 | Jobs URL                  | url     |
| `coverImage`              | Cover Image               | url     |
| `slug`                    | Slug                      | text    |
| `active`                  | Active                    | boolean |
| `verified`                | Verified                  | boolean |
| `pageType`                | Page Type                 | text    |
| `industriesHierarchy`     | Industries Hierarchy      | text    |
| `industriesName`          | Industries Name           | text    |
| `industriesTitle`         | Industries Title          | text    |
| `locationsCity`           | Locations City            | text    |
| `locationsCountry`        | Locations Country         | text    |
| `locationsDescription`    | Locations Description     | text    |
| `locationsGeographicArea` | Locations Geographic Area | text    |
| `locationsHeadquarter`    | Locations Headquarter     | boolean |
| `locationsLine1`          | Locations Line1           | text    |
| `locationsLine2`          | Locations Line2           | text    |
| `parsedCity`              | Parsed City               | text    |
| `parsedCountry`           | Parsed Country            | text    |
| `locationsCountryCode`    | Locations Country Code    | text    |
| `locationsState`          | Locations State           | text    |
| `locationsPostalCode`     | Locations Postal Code     | text    |
| `phoneNumber`             | Phone Number              | text    |
| `similarOrganizations`    | Similar Organizations     | array   |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/linkedin/company-search/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "query": "microsoft",
      "maxResults": 3
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/linkedin/company-search/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "query": "microsoft",
      "maxResults": 3
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "linkedinUrl": "https://www.linkedin.com/showcase/startup-services-sat/",
      "companyName": "Startup Services - SAT",
      "tagline": "Your Go-to Growth Partner for Tech Talent and Cost Saving",
      "description": "At SA Technologies, we specialize in helping startups build offshore teams of 10\u2013100-500+ professionals. We bring your vision to life with precision and innovation, create scalable business models, manage daily operations, and ensures a smooth transition to your control.\n\nWe've successfully helped companies in overcoming recruitment challenges, unifying app development, and boosting productivity with generative AI. \nOur global hiring solutions offer unparalleled simplicity in onboarding talent across various regions. Whether it's offshore, nearshore, on-site, or through our Employer-of-Record (EOR) services, we ensure compliance and cost-effectiveness while providing high-quality talent. \n\nOur technology solutions include UI/UX design, web development, mobile app development, and AI-powered next-gen solutions.\n\nWith over 1000+ projects delivered, SA Technologies is your partner in scaling your startup's success.\nLearn more: https://www.satincorp.com/startups",
      "website": "https://www.satincorp.com/startups/",
      "logo": "https://media.licdn.com/dms/image/v2/D560BAQEXgKINmgf-aA/company-logo_400_400/company-logo_400_400/0/1718178797814?e=1778112000&v=beta&t=qn2TvxYedjrVyUtCV3D0AFVtB8FPl2sSlyN0JUoV9ag",
      "employees": null,
      "employeeRangeMin": 501,
      "employeeRangeMax": 1000,
      "followers": 242,
      "founded": 2003,
      "specialties": [
        "outsourcing talent",
        "Tech Talent Outsourcing",
        "Team Outsourcing",
        "Tech Outsourcing",
        "Startup Hiring",
        "Offshore Hiring"
      ],
      "ctaLink": "https://www.satincorp.com/startups/",
      "jobsUrl": "https://www.linkedin.com/jobs/search?geoId=92000000&f_C=103061528",
      "coverImage": "https://media.licdn.com/dms/image/v2/D561BAQFfCbCelOLtMg/company-background_10000/company-background_10000/0/1719845003867/startup_services_sat_cover?e=1776934800&v=beta&t=tj5ZNXucTvHzyzIb1j-EUBnVLTfBTxQ_wCp2LqQmolI",
      "slug": "startup-services-sat",
      "active": true,
      "verified": false,
      "pageType": "SHOWCASE",
      "industriesHierarchy": null,
      "industriesName": null,
      "industriesTitle": null,
      "locationsCity": null,
      "locationsCountry": null,
      "locationsDescription": null,
      "locationsGeographicArea": null,
      "locationsHeadquarter": null,
      "locationsLine1": null,
      "locationsLine2": null,
      "parsedCity": null,
      "parsedCountry": null,
      "locationsCountryCode": null,
      "locationsState": null,
      "locationsPostalCode": null,
      "phoneNumber": null,
      "similarOrganizations": []
    }
  ]
}
```