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
  }
}
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
  }
}