> ## 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 LinkedIn company pages with advanced filters

## Description

This endpoint allows you to search LinkedIn company pages using various advanced filtering criteria.

<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>

## Headers

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

## Body Parameters

<ParamField body="keyword" type="string" required>
  Keyword to search for (company name, industry, etc.)

  Also supports `company_name` for backward compatibility
</ParamField>

<ParamField body="industry" type="string">
  Industry sector (e.g., "technology", "finance", "healthcare")
</ParamField>

<ParamField body="location" type="string">
  Location (e.g., "Paris", "France", "New York")
</ParamField>

<ParamField body="employee_range" type="string">
  Employee count range (e.g., "1-50", "51-200", "201-1000", "1000+")
</ParamField>

<ParamField body="founding_company" type="boolean">
  Filter for founding companies

  * `true`: Search only founding companies
  * `false`: Exclude founding companies
</ParamField>

<ParamField body="total_results" type="integer" default="10">
  Number of results to return

  * Minimum: 1
  * Maximum: 50,000
  * Default: 10
</ParamField>

## Response

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

<ResponseField name="data" type="object">
  <Expandable title="Response Data">
    <ResponseField name="total_results" type="integer">
      Total count of all matching results
    </ResponseField>

    <ResponseField name="companies" type="array">
      List of found companies

      <Expandable title="Company Structure">
        <ResponseField name="url" type="string">
          Company LinkedIn profile URL
        </ResponseField>

        <ResponseField name="title" type="string">
          Company title/name from LinkedIn
        </ResponseField>

        <ResponseField name="description" type="string">
          Company description
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="message" type="string">
  Error message (if status = "error")
</ResponseField>

## Request Example

```python theme={null}
import requests

url = "https://api.linkupapi.com/v1/data/search/companies"

payload = {
    "keyword": "technology",
    "industry": "technology",
    "location": "Paris",
    "employee_range": "51-200",
    "founding_company": True,
    "total_results": 20
}
headers = {
    "x-api-key": "your-api-key-here",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

```json theme={null}
{
  "keyword": "technology",
  "industry": "technology",
  "location": "Paris",
  "employee_range": "51-200",
  "founding_company": true,
  "total_results": 20
}
```

## Request Example with Arrays

```python theme={null}
import requests

url = "https://api.linkupapi.com/v1/data/search/companies"

payload = {
    "keyword": ["technology", "fintech", "startup"],
    "industry": ["technology", "finance", "healthcare"],
    "location": ["Paris", "Lyon", "Bordeaux"],
    "employee_range": ["1-50", "51-200", "201-1000"],
    "founding_company": True,
    "total_results": 30
}
headers = {
    "x-api-key": "your-api-key-here", 
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

```json theme={null}
{
  "keyword": ["technology", "fintech", "startup"],
  "industry": ["technology", "finance", "healthcare"],
  "location": ["Paris", "Lyon", "Bordeaux"],
  "employee_range": ["1-50", "51-200", "201-1000"],
  "founding_company": true,
  "total_results": 30
}
```

## Response Example

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "data": {
      "total_results": 2847,
      "companies": [
        {
          "url": "https://uk.linkedin.com/company/crm.com",
          "title": "CRM.COM - LinkedIn",
          "description": "CRM.COM is a global specialist in designing and developing commerce, fintech and subscription-based solutions, ideal for the new generation digital consumers."
        },
        {
          "url": "https://www.linkedin.com/company/recruitcrm",
          "title": "Recruit CRM - LinkedIn",
          "description": "Recruit CRM builds cloud-based software for the global Recruitment & Staffing industry. We are on a mission to help recruitment firms grow faster with cutting ..."
        },
        {
          "url": "https://www.linkedin.com/company/aesthetix-crm",
          "title": "Aesthetix CRM - LinkedIn",
          "description": "The #1 CRM platform for plastic surgeons and medical spas. Aesthetix CRM gives your practice access to all the tools you need to grow."
        }
      ]
    }
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "error",
    "message": "keyword (or company_name) is required"
  }
  ```
</ResponseExample>

## Important Notes

* Credit consumption is based on the number of results: 1 credit for 1-10 results, 2 credits for 11-20 results, etc.
* Credits are only deducted on successful searches
* The `company_name` parameter is supported for backward compatibility with `keyword`
* **Single keyword**: Advanced search with optional filters for precise results
* **Multiple keywords**: Automatically activates batch mode for parallel searching
* Most search parameters support both single strings and arrays for flexible searching
* When using multiple keywords, batch mode is automatically activated for optimal performance

## Usage Examples

### Basic search with keyword only

```json theme={null}
{
  "keyword": "artificial intelligence",
  "total_results": 10
}
```

### Search with industry and location filters

```json theme={null}
{
  "keyword": "software",
  "industry": "technology",
  "location": "San Francisco",
  "total_results": 25
}
```

### Search with employee range and founding filter

```json theme={null}
{
  "keyword": "fintech",
  "employee_range": "1-50",
  "founding_company": true,
  "total_results": 15
}
```

### Batch search with multiple keywords

```json theme={null}
{
  "keyword": ["fintech", "blockchain", "cryptocurrency"],
  "industry": ["Finance", "Technology"],
  "location": ["New York", "San Francisco", "London"],
  "employee_range": ["51-200", "201-1000"],
  "total_results": 100
}
```

### Advanced search with multiple industries and locations

```json theme={null}
{
  "keyword": "startup",
  "industry": ["Technology", "Healthcare", "Finance"],
  "location": ["Paris", "Lyon", "Marseille"],
  "employee_range": ["1-50", "51-200"],
  "founding_company": true,
  "total_results": 50
}
```

### Search with specific number of results

```json theme={null}
{
  "keyword": "artificial intelligence",
  "industry": "Technology",
  "total_results": 10
}
```