POST
/
markets
/
{marketId}
/
companies
Authorization
Path
Body
curl --request POST \
  --url https://api-dev.forestreet.com/markets/{marketId}/companies \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "companyName": "<string>",
  "page": 123,
  "itemsPerPage": 123
}'
{
  "meta": {
      "totalItems": 217,
      "currentPage": 1,
      "totalPages": 109,
      "itemsPerPage": 2
  },
  "study_companies": [
      {
          "id": "myplanet.com",
          "logoURL": "https://logo.clearbit.com/myplanet.com",
          "name": "Myplanet",
          "description": "Myplanet is a software studio. They make smarter interfaces to empower your employees and engage your customers. They are on a mission to make business software a lot more delightful, and much more intelligent. Myplanet designs, validates, and develops marketing & commerce platforms, custom business applications, and collaboration solutions that empower employees to deliver great customer experiences. They believe that technology should inspire wonder and support the pursuit of purpose.",
          "foundedYear": 2021,
          "totalFundingAmount": null,
          "hqAddress": "Toronto, Ontario, Canada",
          "hqCity": "Toronto",
          "hqState": "Ontario",
          "hqCountry": "Canada",
          "size": "50-250",
          "fundingRounds": null,
          "IPODate": null,
          "revenue": null,
          "linkedInHandle": "company/myplanethq",
          "twitterHandle": "myplanet",
          "tags": [],
          "professionalEmployeeEstimate": null,
          "funding": null,
          "entryPoint": null,
          "contactNumber": null,
          "contactEmail": null,
          "parentCompany": null,
          "actualRevenue": null,
          "founders": null,
          "ceo": "Jason Cottrell",
          "ukCompaniesHouseIds": null,
          "subsidiaries": null,
          "ukPersonsWithSignificantControl": [],
          "shareholdersList": [],
          "cluster": ""
      },
      {
          "id": "qurious.io",
          "logoURL": "https://logo.clearbit.com/qurious.io",
          "name": "Qurious",
          "description": "We are great believers in the power of human curiosity that is why we are working in stealth! For the last two decades, we have been researching, studying, and digging deep into what makes individuals curious and how curiosity triggers innovation. We have found ourselves obsessing over: What happens when one's curiosity is not fulfilled? Boredom. Loss of interest. Lack of productivity. Acceptance of no better future. Qurious is here to fulfil each and everyone's curiosity with instant answers available at the click of a button.",
          "foundedYear": 2021,
          "totalFundingAmount": null,
          "hqAddress": "20-22 Wenlock Road, London, Greater London, United Kingdom",
          "hqCity": "London",
          "hqState": "Greater London",
          "hqCountry": "United Kingdom",
          "size": "1-10",
          "fundingRounds": null,
          "IPODate": null,
          "revenue": "$0-$1M",
          "linkedInHandle": "company/qurious-tech",
          "twitterHandle": null,
          "tags": [
              "Call-centre integration",
              "Tone & sentiment",
              "Speech analytics",
              "Automatic speech-to-text",
              "Speaker separation",
              "FS Use Cases"
          ],
          "professionalEmployeeEstimate": null,
          "funding": null,
          "entryPoint": null,
          "contactNumber": null,
          "contactEmail": null,
          "parentCompany": null,
          "actualRevenue": 950000,
          "founders": [
              {
                  "name": "Sabrina Atienza",
                  "type": "Person",
                  "image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St%7B6u.%5DyIn%7E.qNb%3D%5C%2FBR3Wfya6%40_%3Bj%3CW4%5El5g3RdAf%7EEpGUtPm20A5g17I%5B7%3AWm%7Eh5K.%7CS%60",
                  "types": [
                      "Person"
                  ],
                  "summary": "Founder at Valued",
                  "diffbotUri": "http://diffbot.com/entity/EKgjgaKFCNLyvKlHr5UY4TQ",
                  "targetDiffbotId": "EKgjgaKFCNLyvKlHr5UY4TQ"
              }
          ],
          "ceo": null,
          "ukCompaniesHouseIds": [
              "13111514"
          ],
          "subsidiaries": null,
          "ukPersonsWithSignificantControl": [
              {
                  "id": 0,
                  "name": "Mr Gurpreet Mann",
                  "ownership": [
                      "25% to 50%"
                  ],
                  "type": "Person",
                  "status": false
              },
              {
                  "id": 1,
                  "name": "Dr Gaurav Gandhi",
                  "ownership": [
                      "25% to 50%"
                  ],
                  "type": "Person",
                  "status": false
              }
          ],
          "shareholdersList": [
              "Mr Gurpreet Mann",
              "Dr Gaurav Gandhi"
          ],
          "cluster": ""
      }
  ]
}

Path

marketId
string

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

Body

companyName
string
default: ""

The name of the company you’d like to return

page
number
default: ""

The page to return from the paginated results

itemsPerPage
number
default: ""

The number of markets to return per page

Response

id
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.

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.