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

# Search Companies

> Search or lookup companies in your network

Search companies by name, domain, or LinkedIn URL. At least one parameter is required.

## Query Parameters

<ParamField query="search" type="string">
  Search by company name (partial match)
</ParamField>

<ParamField query="domain" type="string">
  Lookup by company domain (e.g. `acme.com`)
</ParamField>

<ParamField query="linkedin_url" type="string">
  Lookup by company LinkedIn URL
</ParamField>

<ParamField query="page_size" type="integer" default="25">
  Results per page (max: 100)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/companies?search=Acme" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "companies": [
        {
          "linkedin_numeric_id": "12345678",
          "name": "Acme Corp",
          "industry": "Technology",
          "size": "501-1000",
          "domain": "acme.com"
        }
      ],
      "total": 1
    }
  }
  ```
</ResponseExample>