GET
/
markets
/
{marketId}
/
companies
/
countries
curl --request GET \
  --url https://api.forestreet.com/markets/{marketId}/companies/countries \
  --header 'x-api-key: <api-key>'
{
  "meta": {
    "totalItems": 26,
    "totalUniqueCompanies": 164
  },
  "currentQuery": {
    "marketId": 2
  },
  "data": {
    "United States": 94,
    "United Kingdom": 18,
    "Canada": 8,
    "Germany": 5,
    "Australia": 4,
    "France": 4,
    "Netherlands": 4,
    "Spain": 4,
    "Israel": 3,
    "India": 2,
    "Italy": 2,
    "South Africa": 2,
    "Austria": 1,
    "Bangladesh": 1,
    "Colombia": 1,
    "Cyprus": 1,
    "Czech Republic": 1,
    "Finland": 1,
    "Hong Kong": 1,
    "Hungary": 1,
    "People's Republic of China": 1,
    "Poland": 1,
    "Republic of Ireland": 1,
    "Russia": 1,
    "Switzerland": 1,
    "Turkey": 1
  }
}
This endpoint is deprecated and will be removed in the future. Please use Attributes instead.

Path

marketId
string

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

Response

meta
object

Metadata summarizing the data returned.

data
object

A mapping of all countries to their number of occurrences, sorted by

  • descending number of occurrences, and then
  • alphabetical order of the countries.
{
  "meta": {
    "totalItems": 26,
    "totalUniqueCompanies": 164
  },
  "currentQuery": {
    "marketId": 2
  },
  "data": {
    "United States": 94,
    "United Kingdom": 18,
    "Canada": 8,
    "Germany": 5,
    "Australia": 4,
    "France": 4,
    "Netherlands": 4,
    "Spain": 4,
    "Israel": 3,
    "India": 2,
    "Italy": 2,
    "South Africa": 2,
    "Austria": 1,
    "Bangladesh": 1,
    "Colombia": 1,
    "Cyprus": 1,
    "Czech Republic": 1,
    "Finland": 1,
    "Hong Kong": 1,
    "Hungary": 1,
    "People's Republic of China": 1,
    "Poland": 1,
    "Republic of Ireland": 1,
    "Russia": 1,
    "Switzerland": 1,
    "Turkey": 1
  }
}