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

# FullEnrich: Company Search

> Searching for companies by industry, headcount, domain, and location filters. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Searching for companies by industry, headcount, domain, and location filters.

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

## 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(
  'fullenrich_company_search',
  {
    "offset": 123,
    "limit": 123,
    "search_after": "software companies hiring engineers"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute fullenrich_company_search --input '{
  "offset": 123,
  "limit": 123,
  "search_after": "software companies hiring engineers"
}' --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": {
    "companies": [
      {
        "id": "id_123",
        "name": "Example",
        "domain": "example.com"
      }
    ],
    "metadata": {
      "total": 123,
      "offset": 123,
      "search_after": "software companies hiring engineers"
    }
  }
}
```

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

## Input reference

Search for companies based on various filters. Multiple filters within the same field are combined with AND logic.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.offset` | `integer` | No | — | Number of companies to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search\_after instead. |
| `payload.limit` | `integer` | No | — | Number of companies to return (default: 10, max: 100) |
| `payload.search_after` | `string` | No | — | Cursor-based pagination. Pass the search\_after value from the previous response to get the next page. Works at any point in the result set, but is required to access results beyond the 10,000 offset limit. |
| `payload.names` | `array` | No | — | Filter by company names. Use exact\_match for precise company name matching. |
| `payload.domains` | `array` | No | — | Filter by company domains (e.g., 'google.com', 'microsoft.com'). Exact match recommended. |
| `payload.linkedin_urls` | `array` | No | — | Filter by LinkedIn URLs. |
| `payload.keywords` | `array` | No | — | Filter by description of company |
| `payload.specialties` | `array` | No | — | Filter by specialties of company |
| `payload.industries` | `array` | No | — | Filter by company industries (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Housing and Community Development', 'Warehousing', 'Financial Services'). See [Industries](https://docs.fullenrich.com/api/v2/general/enums#company-industry) for the full list. |
| `payload.types` | `array` | No | — | Filter by company types (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency'). See [Company Types](https://docs.fullenrich.com/api/v2/general/enums#company-type) for the full list. |
| `payload.headquarters_locations` | `array` | No | — | Filter by headquarters locations (city names, regions, or countries) |
| `payload.founded_years` | `array` | No | — | Filter by founding years. Useful for targeting startups (recent years) or established companies. |
| `payload.headcounts` | `array` | No | — | Filter by company headcounts (number of employees). Use ranges to target specific company sizes (e.g., startups: 1-50, mid-size: 50-500, enterprise: 1000+). |
| `payload.company_ids` | `array` | No | — | Filter by specific company IDs |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search for companies based on various filters. Multiple filters within the same field are combined with AND logic.",
    "properties": {
      "offset": {
        "type": "integer",
        "description": "Number of companies to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead."
      },
      "limit": {
        "type": "integer",
        "description": "Number of companies to return (default: 10, max: 100)"
      },
      "search_after": {
        "type": "string",
        "description": "Cursor-based pagination. Pass the search_after value from the previous response to get the next page. Works at any point in the result set, but is required to access results beyond the 10,000 offset limit."
      },
      "names": {
        "type": "array",
        "description": "Filter by company names. Use exact_match for precise company name matching.",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "domains": {
        "type": "array",
        "description": "Filter by company domains (e.g., 'google.com', 'microsoft.com'). Exact match recommended.",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "linkedin_urls": {
        "type": "array",
        "description": "Filter by LinkedIn URLs.",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "keywords": {
        "type": "array",
        "description": "Filter by description of company",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "specialties": {
        "type": "array",
        "description": "Filter by specialties of company",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "industries": {
        "type": "array",
        "description": "Filter by company industries (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Housing and Community Development', 'Warehousing', 'Financial Services'). See [Industries](https://docs.fullenrich.com/api/v2/general/enums#company-industry) for the full list.",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "types": {
        "type": "array",
        "description": "Filter by company types (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency'). See [Company Types](https://docs.fullenrich.com/api/v2/general/enums#company-type) for the full list.",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "headquarters_locations": {
        "type": "array",
        "description": "Filter by headquarters locations (city names, regions, or countries)",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      },
      "founded_years": {
        "type": "array",
        "description": "Filter by founding years. Useful for targeting startups (recent years) or established companies.",
        "items": {
          "type": "object",
          "properties": {
            "min": {
              "type": "integer",
              "description": "Minimum founding year (inclusive)"
            },
            "max": {
              "type": "integer",
              "description": "Maximum founding year (inclusive)"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes companies founded in this range"
            }
          },
          "additionalProperties": false
        }
      },
      "headcounts": {
        "type": "array",
        "description": "Filter by company headcounts (number of employees). Use ranges to target specific company sizes (e.g., startups: 1-50, mid-size: 50-500, enterprise: 1000+).",
        "items": {
          "type": "object",
          "properties": {
            "min": {
              "type": "integer",
              "description": "Minimum number of employees (inclusive)"
            },
            "max": {
              "type": "integer",
              "description": "Maximum number of employees (inclusive)"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes companies in this range"
            }
          },
          "additionalProperties": false
        }
      },
      "company_ids": {
        "type": "array",
        "description": "Filter by specific company IDs",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "string",
              "description": "The string value to filter by"
            },
            "exclude": {
              "type": "boolean",
              "description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
            },
            "exact_match": {
              "type": "boolean",
              "description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
            }
          },
          "additionalProperties": false
        }
      }
    },
    "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 | — | Array of companies matching the search criteria. Returns empty array if no results found. |
| `result.data.companies[].id` | `string` | No | — | Unique company identifier |
| `result.data.companies[].name` | `string` | No | — | Company name |
| `result.data.companies[].domain` | `string` | No | — | Company domain |
| `result.data.companies[].description` | `string` | No | — | Company description |
| `result.data.companies[].year_founded` | `integer` | No | — | Year the company was founded. Returns 0 when unknown. |
| `result.data.companies[].headcount` | `integer` | No | — | Exact number of employees. May return 0 even when headcount\_range is available. |
| `result.data.companies[].headcount_range` | `string` | No | — | Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+') |
| `result.data.companies[].company_type` | `string` | No | — | Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency') |
| `result.data.companies[].locations` | `object` | No | — | Company location information |
| `result.data.companies[].locations.headquarters` | `object` | No | — | Main headquarters address with structured location fields. Can be an empty object when no headquarters data is available. |
| `result.data.companies[].locations.headquarters.line1` | `string` | No | — | Address line 1 (street address) |
| `result.data.companies[].locations.headquarters.line2` | `string` | No | — | Address line 2 (full location string including city, region, postal code, and country code) |
| `result.data.companies[].locations.headquarters.city` | `string` | No | — | City name |
| `result.data.companies[].locations.headquarters.region` | `string` | No | — | State or region |
| `result.data.companies[].locations.headquarters.country` | `string` | No | — | Country name |
| `result.data.companies[].locations.headquarters.country_code` | `string` | No | — | ISO country code |
| `result.data.companies[].locations.offices` | `array \| null` | No | — | Additional office locations. Only contains raw address lines (line1, line2) without structured city/region/country fields. Can be null or an empty array. |
| `result.data.companies[].locations.offices[].line1` | `string` | No | — | Street address |
| `result.data.companies[].locations.offices[].line2` | `string` | No | — | Full location string (city, region, postal code, country code) |
| `result.data.companies[].social_profiles` | `object` | No | — | Company's social media profiles |
| `result.data.companies[].social_profiles.linkedin` | `object` | No | — | LinkedIn profile information |
| `result.data.companies[].social_profiles.linkedin.url` | `string` | No | — | Full LinkedIn profile URL |
| `result.data.companies[].social_profiles.linkedin.handle` | `string` | No | — | LinkedIn profile handle/username |
| `result.data.companies[].social_profiles.linkedin.connection_count` | `integer` | No | — | Number of LinkedIn followers/connections |
| `result.data.companies[].specialties` | `array` | No | — | Specialties associated with the company |
| `result.data.companies[].industry` | `object` | No | — | Company industry information |
| `result.data.companies[].industry.main_industry` | `string` | No | — | Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare', 'Retail') |
| `result.data.metadata` | `object` | No | — | — |
| `result.data.metadata.total` | `integer` | No | — | Total number of results matching the search criteria |
| `result.data.metadata.offset` | `integer` | No | — | Number of results skipped (for pagination) |
| `result.data.metadata.search_after` | `string` | No | — | The cursor value returned by the previous page. Use this to paginate through the results. |
| `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",
            "description": "Array of companies matching the search criteria. Returns empty array if no results found.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Unique company identifier"
                },
                "name": {
                  "type": "string",
                  "description": "Company name"
                },
                "domain": {
                  "type": "string",
                  "description": "Company domain"
                },
                "description": {
                  "type": "string",
                  "description": "Company description"
                },
                "year_founded": {
                  "type": "integer",
                  "description": "Year the company was founded. Returns 0 when unknown."
                },
                "headcount": {
                  "type": "integer",
                  "description": "Exact number of employees. May return 0 even when headcount_range is available."
                },
                "headcount_range": {
                  "type": "string",
                  "description": "Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+')"
                },
                "company_type": {
                  "type": "string",
                  "description": "Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency')"
                },
                "locations": {
                  "type": "object",
                  "description": "Company location information",
                  "properties": {
                    "headquarters": {
                      "type": "object",
                      "description": "Main headquarters address with structured location fields. Can be an empty object when no headquarters data is available.",
                      "properties": {
                        "line1": {
                          "type": "string",
                          "description": "Address line 1 (street address)"
                        },
                        "line2": {
                          "type": "string",
                          "description": "Address line 2 (full location string including city, region, postal code, and country code)"
                        },
                        "city": {
                          "type": "string",
                          "description": "City name"
                        },
                        "region": {
                          "type": "string",
                          "description": "State or region"
                        },
                        "country": {
                          "type": "string",
                          "description": "Country name"
                        },
                        "country_code": {
                          "type": "string",
                          "description": "ISO country code"
                        }
                      },
                      "additionalProperties": false
                    },
                    "offices": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "description": "Additional office locations. Only contains raw address lines (line1, line2) without structured city/region/country fields. Can be null or an empty array.",
                      "items": {
                        "type": "object",
                        "description": "Office address. Unlike headquarters, office addresses only contain raw address lines without parsed location fields.",
                        "properties": {
                          "line1": {
                            "type": "string",
                            "description": "Street address"
                          },
                          "line2": {
                            "type": "string",
                            "description": "Full location string (city, region, postal code, country code)"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "social_profiles": {
                  "type": "object",
                  "description": "Company's social media profiles",
                  "properties": {
                    "linkedin": {
                      "type": "object",
                      "description": "LinkedIn profile information",
                      "properties": {
                        "url": {
                          "type": "string",
                          "description": "Full LinkedIn profile URL"
                        },
                        "handle": {
                          "type": "string",
                          "description": "LinkedIn profile handle/username"
                        },
                        "connection_count": {
                          "type": "integer",
                          "description": "Number of LinkedIn followers/connections"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                },
                "specialties": {
                  "type": "array",
                  "description": "Specialties associated with the company",
                  "items": {
                    "type": "string"
                  }
                },
                "industry": {
                  "type": "object",
                  "description": "Company industry information",
                  "properties": {
                    "main_industry": {
                      "type": "string",
                      "description": "Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare', 'Retail')"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            }
          },
          "metadata": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "description": "Total number of results matching the search criteria"
              },
              "offset": {
                "type": "integer",
                "description": "Number of results skipped (for pagination)"
              },
              "search_after": {
                "type": "string",
                "description": "The cursor value returned by the previous page. Use this to paginate through the results."
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.09` per pricing unit.

## Related documentation

* [FullEnrich provider guide](https://deepline.com/docs/providers/fullenrich/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.