POST
/
markets
/
{marketId}
/
companies

Path

marketId
string

The ID of the market whose companies you want to retrieve. This can be retrieved by searching for markets.

Body Request Object Example

{
    "page": 1,
    "itemsPerPage": 2,
    "sorts": {
        "foundedYear": "desc",
        "actualRevenue": "asc",
        "score": "desc"
    },
    "filters": {
        "company": [],
        "topics": [],
        "dunsNumber": [9524357492],
        "locations": {
            "country": ["United States"],
            "state": ["California"],
            "city": ["San Francisco"]
        },
        "naics": [336110],
        "sicUS": [3711],
        "sicUK": [29100],
        "minScore": 0.5,
        "maxScore": 1
    },
}

Body

page
number
default: ""

The page to return from the paginated results

itemsPerPage
number
default: ""

The number of markets to return per page

sorts
object
default: ""

The sort order for the results. The key is the field to sort by and the value is the sort order.

filters
object
default: ""

The filters to apply to the results. The key is the field to filter by and the value is the filter value.

fields
array
default: ""

The fields to return in the response. If not specified, all fields will be returned.

Response

market
object

The details of the market being queried.

domain
string

The unique domain identifier for the company.

logoURL
string

The URL pointing to the company’s logo.

name
string

The official name of the company.

description
string

A brief description of the company and its operations.

foundedYear
number

The year the company was founded.

totalFundingAmount
number|null

The total amount of funding received by the company. Null if not available.

hqAddress
string

The full address of the company’s headquarters.

hqCity
string

The city where the company’s headquarters is located.

hqState
string

The state or region of the company’s headquarters.

hqCountry
string

The country where the company’s headquarters is located.

operatesIn
array

The locations the company have recently operated in.

size
string

The size or employee range of the company.

fundingRounds
number|null

The total number of funding rounds the company has gone through. Null if not available.

IPODate
date|null

The date when the company went public. Null if it hasn’t or the date is not available.

revenue
string

The estimated revenue range of the company.

linkedInHandle
string

The company’s LinkedIn profile handle.

twitterHandle
string

The company’s Twitter handle.

tags
array

An array of tags or services associated with the company.

momentum
object

A score of how well the company is performing in this market, based on different factors. A score of 100 being the best.

funding
object|null

Details about the company’s funding. Null if not available.

entryPoint
string|null

The entry point or initial contact for the company. Null if not provided.

contactNumber
string

The primary contact number for the company.

contactEmail
string

The primary contact email for the company.

naics
array

The NAICS codes associated with the company.

sicUS
array

The US SIC codes associated with the company.

sicUK
array

The UK SIC codes associated with the company.

diversityCertifications
array

This field contains an array of strings, each representing a specific diversity-related certification, recognition, or affiliation that the company holds or offers.