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

# Search Companies

> Search for companies on LinkedIn using various filters

Search and retrieve information about companies on LinkedIn using filters like location, sector, keywords, and company size.

<Note>
  **Credit Usage:** 1 credit per 10 results (or fraction thereof). For example:

  * 1-10 results = 1 credit
  * 11-20 results = 2 credits
  * 300 results = 30 credits
</Note>

### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key
</ParamField>

### Body Parameters

<ParamField body="location" type="string">
  Geographic location for company search (e.g., "Paris", "France", "Europe").
  Use semicolon (;) as separator for multiple locations (e.g., "Paris;London;Berlin").
</ParamField>

<ParamField body="sector" type="string">
  Industry sector you can find the label here:
  `api.linkupapi.com/v1/tool/industries`
  Use semicolon (;) as separator for multiple sectors (e.g., "Software;Finance;Marketing").
</ParamField>

<ParamField body="industry" type="string">
  Industry to filter companies by.
  Use semicolon (;) as separator for multiple industries (e.g., "software;marketing;finance").

  Get the full list of available industries at: `api.linkupapi.com/v1/tool/industries`
</ParamField>

<ParamField body="keyword" type="string">
  Search keyword or company name
</ParamField>

<ParamField body="company_size" type="string">
  Employee count range:
  1-10 employees
  11-50 employees
  51-200 employees
  201-500 employees
  501-1000 employees
  1001-5000 employees
  5001-10000 employees
  10001+ employees
</ParamField>

<ParamField body="total_results" type="integer" default="10">
  Number of companies to return (used when not in pagination mode)
</ParamField>

<ParamField body="start_page" type="integer">
  First page to fetch when using pagination mode (default: 1)
</ParamField>

<ParamField body="end_page" type="integer">
  Last page to fetch when using pagination mode (default: same as start\_page)
</ParamField>

<ParamField body="country" type="string" default="FR">
  Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
</ParamField>

<ParamField body="login_token" type="string" required>
  LinkedIn authentication cookie obtained from the login/verify process
</ParamField>

### Response

<ResponseField name="status" type="string">
  Request status (success/error)
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Properties">
    <ResponseField name="total_results" type="integer">
      Number of companies returned in the response
    </ResponseField>

    <ResponseField name="total_available_results" type="integer">
      Total number of results available in LinkedIn matching your search criteria
    </ResponseField>

    <ResponseField name="companies" type="array">
      <Expandable title="Company Object">
        <ResponseField name="company_name" type="string">
          Name of the company
        </ResponseField>

        <ResponseField name="company_url" type="string">
          LinkedIn URL of the company
        </ResponseField>

        <ResponseField name="job_offers" type="string">
          Current job openings information (null if not available)
        </ResponseField>

        <ResponseField name="subscribers" type="string">
          Number of LinkedIn followers
        </ResponseField>

        <ResponseField name="location" type="string">
          Company's primary location and industry
        </ResponseField>

        <ResponseField name="logo_url" type="string">
          URL of company logo (if available)
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="pagination" type="object">
      <Expandable title="Pagination Object">
        <ResponseField name="start_page" type="integer">
          First page fetched in the current request
        </ResponseField>

        <ResponseField name="end_page" type="integer">
          Last page fetched in the current request
        </ResponseField>

        <ResponseField name="results_per_page" type="integer">
          Number of results per page (typically 50)
        </ResponseField>

        <ResponseField name="pages_fetched" type="integer">
          Total number of pages fetched in the current request
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": "success",
    "data": {
      "total_results": 2,
      "total_available_results": 1368,
      "companies": [
        {
          "company_name": "Software République",
          "company_url": "https://www.linkedin.com/company/softwarerepublique/",
          "job_offers": null,
          "subscribers": "4 k abonnés",
          "location": "Développement de logiciels • Paris",
          "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQEOM_2p0wtaWQ/company-logo_100_100/company-logo_100_100/0/1653290912803?e=1749081600&v=beta&t=qshekRz09DUyP6lo2KEQppZBMj-gJ7zmzj-3saswwkA"
        },
        {
          "company_name": "Software Club",
          "company_url": "https://www.linkedin.com/company/softwareclub/",
          "job_offers": "2 offres d'emploi",
          "subscribers": "8 k abonnés",
          "location": "Technologie, information et Internet • Paris, Île-de-France",
          "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQGtU0gjNC8ONw/company-logo_100_100/company-logo_100_100/0/1673453153703/softwareclub_logo?e=1749081600&v=beta&t=E4mMCkbmbIcBbLsAHSj_PGP5FBHPQfJ3eVlexTGEdo8"
        }
      ],
      "pagination": {
        "start_page": 1,
        "end_page": 1,
        "results_per_page": 50,
        "pages_fetched": 1
      }
    }
  }
  ```
</ResponseExample>

### Notes

* All filter parameters are optional but at least one should be provided for meaningful results
* Results are paginated with a maximum of 50 companies per page
* Location and sector IDs are automatically resolved from provided strings
* The `total_available_results` field shows the total number of companies that match your search criteria on LinkedIn
* The `job_offers` field may be null if no job listings are currently available
* **Pagination Mode vs. Total Results Mode**:
  * **Total Results Mode**: Use the `total_results` parameter to specify how many companies you want (default)
  * **Pagination Mode**: Use `start_page` and `end_page` parameters to fetch specific pages of results
  * Credit usage in pagination mode is based on the number of pages fetched (1 credit per page)
  * When using pagination mode, `total_results` parameter is ignored