Search for companies.

post

https://api.visualvisitor.com/api/v1/whoToContact/company

Minimal scope required: "customers.read".

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

customerId

string | null

Queried customer must have a +PlusEmployee plan enabled.
Optional query parameter, allowing partners to perform this action on behalf of their customer.

api-version

string | null

Body Params

The JSON object containing the search filters.

DTO used to search for companies based on various firmographic and location criteria.

page

int32

The current page number for pagination, with a maximum allowed value of 50.

pageSize

int32

The number of records per page for pagination, with a maximum allowed value of 200.

companyNames

array of strings | null

Optional, the list of company names to filter by.

companyNames

companyWebsites

array of strings | null

Optional, the list of company websites to filter by.

companyWebsites

companyIndustryValues

array of strings | null

Optional, the list of company industries to filter by.
Required values can be retrieved from the endpoint: /api/v1/reference/companyIndustries.

companyIndustryValues

companySicValues

array of strings | null

Optional, the list of company SIC codes to filter by.
Required values can be retrieved from the endpoint: /api/v1/reference/companySics.

companySicValues

companyNaicsValues

array of strings | null

Optional, the list of company NAICS codes to filter by.
Required values can be retrieved from the endpoint: /api/v1/reference/companyNaics.

companyNaicsValues

companyEmployeeSizeValues

array of strings | null

Optional, the list of company size identifiers to filter by.
Required values can be retrieved from the endpoint: /api/v1/reference/companyEmployeeSizes.

companyEmployeeSizeValues

companyRevenueBandValues

array of strings | null

Optional, the list of company revenue identifiers to filter by.
Required values can be retrieved from the endpoint: /api/v1/reference/companyRevenueBands.

companyRevenueBandValues

companyLocationTypeValues

array of strings | null

Optional, the list of location types to filter by (e.g., headquarters, branch).
Required values can be retrieved from the endpoint: /api/v1/reference/companyLocationType.

companyLocationTypeValues

countryValues

array of strings | null

Optional, the list of countries to filter by.
Required values can be retrieved from the endpoint: /api/v1/reference/countries.

countryValues

stateValues

array of strings | null

Optional, the list of states to filter by.
Required values can be retrieved from the endpoint: /api/v1/reference/states.

stateValues

cities

array of strings | null

Optional, the list of cities to filter by.

cities

zipCodes

array of strings | null

Optional, the list of zip codes to filter by.

zipCodes

Headers

X-Version

string | null

Responses

500

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200

400

401

403

404

429