---
title: "Search Companies"
method: POST
path: "/api/v1/companies/search"
---

# Search Companies

`POST /api/v1/companies/search`

## Request

- Base URL: `https://api.dropleads.io`
- URL: `https://api.dropleads.io/api/v1/companies/search`
- Auth: API key in header `X-API-Key`

Search for companies using filters. **Each company returned in the current page costs 0.1 credit**.

## Headers

- `Content-Type` string, required

## Request body

- object
  - `filters` object: All fields optional. Combined with AND.
    - `companyNames` string[]
    - `companyDomains` string[]
    - `linkedinUrls` string[]
    - `industries` string[]
    - `industriesExclude` string[]
    - `keywords` string[]
    - `keywordsExclude` string[]
    - `technologies` string[]
    - `technologiesExclude` string[]
    - `employeeRanges` string[]
    - `customEmployeeRange` object
      - `min` integer
      - `max` integer
    - `revenueRange` object
      - `min` number, nullable
      - `max` number, nullable
    - `fundingRange` object
      - `min` number, nullable
      - `max` number, nullable
    - `foundedYear` object
      - `min` integer, nullable
      - `max` integer, nullable
    - `countries` object
      - `include` string[]
      - `exclude` string[]
    - `states` object
      - `include` string[]
      - `exclude` string[]
    - `cities` object
      - `include` string[]
      - `exclude` string[]
    - `regions` object: Expands to countries.
      - `include` string[]
      - `exclude` string[]
    - `lists` object
      - `type` 'include' | 'exclude'
      - `listIds` string[]
  - `pagination` object
    - `page` integer
    - `limit` integer

## Response `200`

Successful response

- object
  - `success` boolean
  - `data` object
    - `companies` object[]
      - `id` string: Primary domain, used as the unique company key.
      - `name` string
      - `domain` string
      - `websiteUrl` string
      - `linkedinUrl` string
      - `industry` string
      - `keywords` string, nullable
      - `employees` integer, nullable
      - `foundedYear` integer, nullable
      - `annualRevenue` number, nullable
      - `totalFunding` number, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `country` string, nullable
      - `phone` string, nullable
      - `technologyNames` string, nullable
    - `total` integer
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `404`: Not found

---

[API](https://skmtc.dev/dropleads/apis/data-enrichment.md) - [All operations](https://skmtc.dev/dropleads/apis/data-enrichment/llms.txt) - [OpenAPI document](https://skmtc.dev/dropleads/apis/data-enrichment/revisions/293a8d3add39?raw)