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

# Deepline Native: Free Company Lookup

> Free lookup of one company by domain, LinkedIn company URL or exact name. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Free lookup of one company by domain, LinkedIn company URL or exact name.

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

## 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(
  'free_company_lookup',
  {
    "domain": "example.com",
    "linkedin_url": "https://www.linkedin.com/in/jane-doe",
    "company_name": "Example Corp"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute free_company_lookup --input '{
  "domain": "example.com",
  "linkedin_url": "https://www.linkedin.com/in/jane-doe",
  "company_name": "Example Corp"
}' --json
```

## 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": {
    "key_type": "domain",
    "key": "example",
    "matches": [
      {
        "normalized_domain": "example.com",
        "domain": "example.com",
        "company_name": "Example Corp",
        "industry": "example",
        "location": "example",
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "employee_count": 1,
        "year_founded": 1
      }
    ]
  }
}
```

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

## Input reference

Look one company up in the free company corpus by exactly one of domain, LinkedIn URL or exact name. In a Play, row-by-row lookups are sent to Snowflake together in batches of up to 100.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.domain` | `string` | No | — | Company website or domain, e.g. 'stripe.com' or '[https://www.stripe.com/about](https://www.stripe.com/about)'. Scheme, [www](http://www)., path and a trailing dot are removed. subdomains are kept. Minimum length: 1. |
| `payload.linkedin_url` | `string` | No | — | LinkedIn company URL, e.g. '[https://www.linkedin.com/company/stripe/](https://www.linkedin.com/company/stripe/)'. Compared case-insensitively. Minimum length: 1. |
| `payload.company_name` | `string` | No | — | Exact company name, compared case-insensitively, e.g. 'Stripe'. Not a prefix or fuzzy match. Minimum length: 1. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Look one company up in the free company corpus by exactly one of domain, LinkedIn URL or exact name. In a Play, row-by-row lookups are sent to Snowflake together in batches of up to 100.",
    "properties": {
      "domain": {
        "type": "string",
        "description": "Company website or domain, e.g. 'stripe.com' or 'https://www.stripe.com/about'. Scheme, www., path and a trailing dot are removed; subdomains are kept.",
        "minLength": 1
      },
      "linkedin_url": {
        "type": "string",
        "description": "LinkedIn company URL, e.g. 'https://www.linkedin.com/company/stripe/'. Compared case-insensitively.",
        "minLength": 1
      },
      "company_name": {
        "type": "string",
        "description": "Exact company name, compared case-insensitively, e.g. 'Stripe'. Not a prefix or fuzzy match.",
        "minLength": 1
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Output reference

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | — |
| `result.data.key_type` | `"domain" \| "linkedin_url" \| "company_name"` | Yes | — | Allowed: `domain`, `linkedin_url`, `company_name`. |
| `result.data.key` | `string` | Yes | — | The key as it was matched, normalized. |
| `result.data.matches` | `array` | Yes | — | Up to 5 companies with this key, largest first. Empty when none match. |
| `result.data.matches[].normalized_domain` | `string \| null` | Yes | — | — |
| `result.data.matches[].domain` | `string \| null` | Yes | — | — |
| `result.data.matches[].company_name` | `string` | Yes | — | — |
| `result.data.matches[].industry` | `string \| null` | Yes | — | — |
| `result.data.matches[].location` | `string \| null` | Yes | — | — |
| `result.data.matches[].linkedin_url` | `string \| null` | Yes | — | — |
| `result.data.matches[].employee_count` | `integer \| null` | Yes | — | — |
| `result.data.matches[].year_founded` | `integer \| null` | Yes | — | — |

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

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "properties": {
      "data": {
        "type": "object",
        "properties": {
          "key_type": {
            "type": "string",
            "enum": [
              "domain",
              "linkedin_url",
              "company_name"
            ]
          },
          "key": {
            "type": "string",
            "description": "The key as it was matched, normalized."
          },
          "matches": {
            "type": "array",
            "description": "Up to 5 companies with this key, largest first. Empty when none match.",
            "items": {
              "type": "object",
              "properties": {
                "normalized_domain": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "domain": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "company_name": {
                  "type": "string"
                },
                "industry": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "location": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "linkedin_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "employee_count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "year_founded": {
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "required": [
                "normalized_domain",
                "domain",
                "company_name",
                "industry",
                "location",
                "linkedin_url",
                "employee_count",
                "year_founded"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "key_type",
          "key",
          "matches"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

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