---
title: "Search companies"
method: POST
path: "/public/v1/insights/companies"
tags: ["Search"]
---

# Search companies

`POST /public/v1/insights/companies`

This API endpoint finds companies in GetProspect companies’ database by different search criteria.

## Query parameters

- `pageSize` number
- `pageNumber` number
- `sort` 'id' | 'name' | 'domain' | 'size' | 'headquarters' | 'description' | 'postalCode' | 'location.region' | 'location.timezone' | 'location.location' | 'location.countryCode'
- `order` 'ASC' | 'DESC'

## Request body

- SearchCompaniesDto
  - `name` SearchTextCompanyFilter
    - `included` string[]
    - `excluded` string[]
  - `domain` SearchTextCompanyFilter
    - `included` string[]
    - `excluded` string[]
  - `industry` SearchIndustryCompanyFilter
    - `included` string[]
    - `excluded` string[]
  - `location` SearchTextCompanyFilter
    - `included` string[]
    - `excluded` string[]
  - `keywords` SearchTextCompanyFilter
    - `included` string[]
    - `excluded` string[]
  - `lastUpdated` string, full-date
  - `employees` SearchCountCompanyFilter
    - `included` '1 - 10' | '11 - 20' | '21 - 50' | '51 - 100' | '101 - 200' | '201 - 500' | '501 - 1000' | '1001 - 2000' | '2001 - 5000' | '5001 - 10000' | '10000'

## Response `200`

Entity given

- PaginatedCompaniesData
  - `data` CompanyResponseDto[], required
    - `name` string, required
    - `domain` string, required
    - `description` string, required
    - `headquarters` string, required
    - `industry` string, required
    - `postalCode` string, required
    - `size` number, required
    - `linkedin` LinkedinResponseDto[], required
      - `id` string, required
      - `type` string, required
    - `location` Geolocation, required
      - `location` string, required
      - `countryCode` string, required
      - `region` string, required
      - `timezone` string, required
    - `getProspectId` string, required
    - `technologies` Technology[], required
      - `website` string, required
      - `name` string, required
      - `categories` TechnologyCategory[], required
        - `name` string, required
        - `getProspectId` string, required
        - `slug` string, required
      - `getProspectId` string, required
      - `slug` string, required
  - `meta` Meta, required
    - `totalPages` number, required
    - `totalItems` number, required
    - `savedItems` number, required
    - `pageSize` number, required
    - `page` number, required
    - `sort` Sort, required
      - `column` string, required
      - `order` 'ASC' | 'DESC', required
    - `additionalInfo` object, required

## Other responses

- `400` — Bad model
- `401` — Unauthorized user

---

[API](https://skmtc.net/getprospect/apis/calls.md) · [All operations](https://skmtc.net/getprospect/apis/calls/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getprospect/calls/revisions/5211a12644da/schema)