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

# CrustData V2: Company Search Realtime

> Search company profiles on the web in real time using a set of filters. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Search company profiles on the web in real time using a set of filters.

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

## 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(
  'crustdata_v2_company_search_realtime',
  {
    "filters": [
      {
        "filter_type": "COMPANY_HEADCOUNT",
        "type": "in",
        "value": [
          "example"
        ]
      }
    ],
    "page": 123
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute crustdata_v2_company_search_realtime --input '{
  "filters": [
    {
      "filter_type": "COMPANY_HEADCOUNT",
      "type": "in",
      "value": [
        "example"
      ]
    }
  ],
  "page": 123
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe crustdata_v2_company_search_realtime --json` for the complete live contract.

## Input reference

Searches for company profiles on the web in real-time. Accepts a set of filters for search criteria. See [How to Build Filters](https://docs.crustdata.com/docs/discover/company-apis/how-to-build-company-filters). [Show Docs](https://docs.crustdata.com/docs/discover/company-apis/company-search-api)

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.filters` | `array` | No | — | — |
| `payload.page` | `integer` | No | — | — |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Searches for company profiles on the web in real-time. Accepts a set of filters for search criteria. See [How to Build Filters](https://docs.crustdata.com/docs/discover/company-apis/how-to-build-company-filters). [Show Docs](https://docs.crustdata.com/docs/discover/company-apis/company-search-api)",
    "properties": {
      "filters": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "filter_type": {
              "type": "string",
              "description": "Type of filter to apply.",
              "enum": [
                "COMPANY_HEADCOUNT",
                "CURRENT_TITLE",
                "COMPANY_HEADQUARTERS",
                "INDUSTRY",
                "REGION"
              ]
            },
            "type": {
              "type": "string",
              "enum": [
                "in",
                "not in",
                "between"
              ]
            },
            "value": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        }
      },
      "page": {
        "type": "integer"
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.companies` | `array` | No | — | — |
| `result.data.companies[].name` | `string` | No | — | — |
| `result.data.companies[].description` | `string` | No | — | — |
| `result.data.companies[].linkedin_company_url` | `string` | No | — | Format: `uri`. |
| `result.data.companies[].linkedin_company_id` | `string` | No | — | — |
| `result.data.companies[].website` | `string` | No | — | Format: `uri`. |
| `result.data.companies[].industry` | `string` | No | — | — |
| `result.data.companies[].company_type` | `string` | No | — | — |
| `result.data.companies[].founded_year` | `integer` | No | — | — |
| `result.data.companies[].location` | `string` | No | — | — |
| `result.data.companies[].headquarters` | `object` | No | — | — |
| `result.data.companies[].headquarters.country` | `string` | No | — | — |
| `result.data.companies[].headquarters.city` | `string` | No | — | — |
| `result.data.companies[].headquarters.postalCode` | `string` | No | — | — |
| `result.data.companies[].headquarters.line2` | `string` | No | — | — |
| `result.data.companies[].headquarters.line1` | `string` | No | — | — |
| `result.data.companies[].employee_count` | `integer` | No | — | — |
| `result.data.companies[].employee_count_range` | `string` | No | — | — |
| `result.data.companies[].employee_growth_percentages` | `array` | No | — | — |
| `result.data.companies[].employee_growth_percentages[].timespan` | `"SIX_MONTHS" \| "YEAR" \| "TWO_YEAR"` | No | — | Allowed: `SIX_MONTHS`, `YEAR`, `TWO_YEAR`. |
| `result.data.companies[].employee_growth_percentages[].percentage` | `number` | No | — | — |
| `result.data.companies[].specialties` | `array` | No | — | — |
| `result.data.companies[].revenue_range` | `object` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMinRevenue` | `object` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMinRevenue.amount` | `number` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMinRevenue.unit` | `string` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMinRevenue.currencyCode` | `string` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMaxRevenue` | `object` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMaxRevenue.amount` | `number` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMaxRevenue.unit` | `string` | No | — | — |
| `result.data.companies[].revenue_range.estimatedMaxRevenue.currencyCode` | `string` | No | — | — |
| `result.data.companies[].decision_makers_count` | `string` | No | — | — |
| `result.data.companies[].logo_urls` | `object` | No | — | — |
| `result.data.companies[].logo_urls.200x200` | `string` | No | — | Format: `uri`. |
| `result.data.companies[].logo_urls.100x100` | `string` | No | — | Format: `uri`. |
| `result.data.companies[].logo_urls.400x400` | `string` | No | — | Format: `uri`. |
| `result.data.total_display_count` | `string` | No | — | Short scale notation (like 1M+ or 1.5K) representing the total number of profiles available for the search. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

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

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "companies": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "linkedin_company_url": {
                  "type": "string",
                  "format": "uri"
                },
                "linkedin_company_id": {
                  "type": "string"
                },
                "website": {
                  "type": "string",
                  "format": "uri"
                },
                "industry": {
                  "type": "string"
                },
                "company_type": {
                  "type": "string"
                },
                "founded_year": {
                  "type": "integer"
                },
                "location": {
                  "type": "string"
                },
                "headquarters": {
                  "type": "object",
                  "properties": {
                    "country": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "postalCode": {
                      "type": "string"
                    },
                    "line2": {
                      "type": "string"
                    },
                    "line1": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                },
                "employee_count": {
                  "type": "integer"
                },
                "employee_count_range": {
                  "type": "string"
                },
                "employee_growth_percentages": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "timespan": {
                        "type": "string",
                        "enum": [
                          "SIX_MONTHS",
                          "YEAR",
                          "TWO_YEAR"
                        ]
                      },
                      "percentage": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "specialties": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "revenue_range": {
                  "type": "object",
                  "properties": {
                    "estimatedMinRevenue": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "number"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "currencyCode": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    },
                    "estimatedMaxRevenue": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "number"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "currencyCode": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                },
                "decision_makers_count": {
                  "type": "string"
                },
                "logo_urls": {
                  "type": "object",
                  "properties": {
                    "200x200": {
                      "type": "string",
                      "format": "uri"
                    },
                    "100x100": {
                      "type": "string",
                      "format": "uri"
                    },
                    "400x400": {
                      "type": "string",
                      "format": "uri"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            }
          },
          "total_display_count": {
            "type": "string",
            "description": "Short scale notation (like 1M+ or 1.5K) representing the total number of profiles available for the search."
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [CrustData V2 provider guide](https://deepline.com/docs/providers/crustdata-v2/guide.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.