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

# LeadMagic: Search Companies

> Search for companies by industry, headcount, location, technology and other filters, or look one up by domain, name or LinkedIn URL.

Search for companies by industry, headcount, location, technology and other filters, or look one up by domain, name or LinkedIn URL.

> [!NOTE]
>
> Tool ID: `leadmagic_search_companies`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'leadmagic_search_companies',
  {
    "company_domain": "example.com",
    "domain": "example.com",
    "website": "https://example.com"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline run leadmagic_search_companies --input '{
  "company_domain": "example.com",
  "domain": "example.com",
  "website": "https://example.com"
}'
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "message": "Example message",
    "companies": [
      {
        "company_domain": "example.com",
        "company_name": "Example Corp",
        "company_website": "https://example.com"
      }
    ],
    "found": true
  }
}
```

Use `deepline describe leadmagic_search_companies --json` for the latest machine-readable contract.

## Input reference

Canonical V3 company lookup with all company filters.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.company_domain` | `string` | No | — | Direct one-company lookup input. Returns one rich company row plus legacy-friendly aliases when no broad filters or explicit limit are supplied. |
| `payload.domain` | `string` | No | — | Alias for company\_domain. |
| `payload.website` | `string` | No | — | Company website URL or domain. |
| `payload.company_name` | `string` | No | — | Company name lookup input. |
| `payload.profile_url` | `string` | No | — | Company profile URL. |
| `payload.linkedin_url` | `string` | No | — | Company profile URL. |
| `payload.company_filters` | `object` | No | — | Full company filter object. |
| `payload.query` | `string` | No | — | — |
| `payload.limit` | `integer` | No | `10` | Minimum: 1. Maximum: 50. |
| `payload.cursor` | `string` | No | — | Opaque next\_cursor from the previous page. Send unchanged with the same filters and limit. |
| `payload.offset` | `integer` | No | `0` | Legacy offset pagination. prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor. Minimum: 0. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Canonical V3 company lookup with all company filters.",
    "properties": {
      "company_domain": {
        "type": "string",
        "description": "Direct one-company lookup input. Returns one rich company row plus legacy-friendly aliases when no broad filters or explicit limit are supplied."
      },
      "domain": {
        "type": "string",
        "description": "Alias for company_domain."
      },
      "website": {
        "type": "string",
        "description": "Company website URL or domain."
      },
      "company_name": {
        "type": "string",
        "description": "Company name lookup input."
      },
      "profile_url": {
        "type": "string",
        "description": "Company profile URL."
      },
      "linkedin_url": {
        "type": "string",
        "description": "Company profile URL."
      },
      "company_filters": {
        "type": "object",
        "description": "Full company filter object.",
        "additionalProperties": true
      },
      "query": {
        "type": "string"
      },
      "limit": {
        "type": "integer",
        "default": 10,
        "minimum": 1,
        "maximum": 50
      },
      "cursor": {
        "type": "string",
        "description": "Opaque next_cursor from the previous page. Send unchanged with the same filters and limit."
      },
      "offset": {
        "type": "integer",
        "description": "Legacy offset pagination; prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor.",
        "default": 0,
        "minimum": 0
      }
    },
    "required": [],
    "additionalProperties": true
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.message` | `string` | No | — | — |
| `result.data.companies` | `array` | No | — | — |
| `result.data.companies[].company_domain` | `string` | No | — | — |
| `result.data.companies[].company_name` | `string` | No | — | — |
| `result.data.companies[].company_website` | `string` | No | — | — |
| `result.data.companies[].company_industry_linkedin` | `string` | No | — | — |
| `result.data.companies[].employee_range` | `string` | No | — | — |
| `result.data.companies[].employee_min` | `integer` | No | — | — |
| `result.data.companies[].employee_max` | `integer` | No | — | — |
| `result.data.companies[].linkedin_employee_count` | `integer` | No | — | — |
| `result.data.companies[].revenue_range` | `string` | No | — | — |
| `result.data.companies[].revenue_min` | `string` | No | — | — |
| `result.data.companies[].revenue_max` | `string` | No | — | — |
| `result.data.companies[].hq_country` | `string` | No | — | — |
| `result.data.companies[].hq_country_code` | `string` | No | — | — |
| `result.data.companies[].hq_city` | `string` | No | — | — |
| `result.data.companies[].hq_state` | `string` | No | — | — |
| `result.data.companies[].hq_street` | `string \| null` | No | — | — |
| `result.data.companies[].hq_postcode` | `string \| null` | No | — | — |
| `result.data.companies[].hq_region` | `string` | No | — | — |
| `result.data.companies[].hq_continent` | `string \| null` | No | — | — |
| `result.data.companies[].location_city` | `string \| null` | No | — | — |
| `result.data.companies[].location_country_code` | `string \| null` | No | — | — |
| `result.data.companies[].location_region` | `string \| null` | No | — | — |
| `result.data.companies[].location_state_code` | `string \| null` | No | — | — |
| `result.data.companies[].founded_year` | `integer \| null` | No | — | — |
| `result.data.companies[].specialties` | `string \| null` | No | — | — |
| `result.data.companies[].total_funding` | `number \| null` | No | — | — |
| `result.data.companies[].funding_investor_count` | `integer \| null` | No | — | — |
| `result.data.companies[].last_funding_type` | `string \| null` | No | — | — |
| `result.data.companies[].last_funding_date` | `string \| null` | No | — | — |
| `result.data.companies[].last_funding_amount` | `number \| null` | No | — | — |
| `result.data.companies[].lead_investors` | `string \| null` | No | — | Not returned in standard company search responses. |
| `result.data.companies[].linkedin_followers` | `integer \| null` | No | — | — |
| `result.data.companies[].growth_rate` | `integer \| null` | No | — | — |
| `result.data.companies[].linkedin_url` | `string \| null` | No | — | — |
| `result.data.companies[].linkedin_claimed` | `boolean` | No | — | — |
| `result.data.companies[].company_headline` | `string \| null` | No | — | — |
| `result.data.companies[].company_about` | `string \| null` | No | — | — |
| `result.data.companies[].company_phone` | `string \| null` | No | — | — |
| `result.data.companies[].company_entity_type` | `string \| null` | No | — | — |
| `result.data.companies[].company_legal_type` | `string \| null` | No | — | — |
| `result.data.companies[].has_tech_stack` | `boolean` | No | — | — |
| `result.data.companies[].profile_completeness_score` | `integer \| null` | No | — | — |
| `result.data.companies[].total_contacts` | `integer` | No | — | — |
| `result.data.companies[].contacts_with_email` | `integer` | No | — | — |
| `result.data.companies[].contacts_with_phone` | `integer` | No | — | — |
| `result.data.companies[].valid_email_count` | `integer` | No | — | — |
| `result.data.companies[].website_active` | `boolean` | No | — | — |

The table shows the first 50 fields. Expand the raw schema below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe leadmagic_search_companies --json`.

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.34` per pricing unit.

## Related documentation

* [Connect integrations](https://deepline.com/docs/integrations.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.