POST
/
markets
/
{marketId}
/
companies
curl --request POST \
  --url https://api.forestreet.com/markets/{marketId}/companies \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "companyName": "<string>",
  "page": 123,
  "itemsPerPage": 123
}'
{
  "meta": {
  "totalItems": 1,
  "currentPage": 1,
  "totalPages": 1,
  "itemsPerPage": 50
},
  "data": [
    {
      "marketId": "655392957a1cddf2d913acbb",
      "domain": "verb8tm.com",
      "logoURL": "https://logo.clearbit.com/verb8tm.com",
      "name": "Verb8tm",
      "description": "Provider of a media conversion platform designed to help clients with captions and transcripts at the low prices. The company's media conversion platform offers a technology-based captioning tool that provides file transcripts as a formatted file for a captioned video within 4 hours of file delivery, enabling clients to develop new and innovative products that saves time and money.",
      "foundedYear": 2015,
      "totalFundingAmount": 175000,
      "hqAddress": "6600 York Road, Baltimore, 21212, Maryland, USA",
      "hqCity": "Baltimore",
      "hqState": "Maryland",
      "hqCountry": "United States",
      "hqLat": 39.319732666015625,
      "hqLng": -76.6495361328125,
      "size": {
      "value": "10-50",
      "sortValue": 1
    },
      "fundingRounds": 1,
      "IPODate": null,
      "revenue": {
      "value": "$1M-$10M",
      "sortValue": 1
    },
      "linkedInHandle": "company/10196327",
      "twitterHandle": "verb8tm",
      "isStarredByForestreet": false,
      "momentum": {
      "funding": null,
      "webTraffic": 84,
      "mediaAnalysis": 30,
      "newsSentiment": null,
      "revenueEstimates": 30
    },
      "overallMomentum": 40,
      "professionalEmployeeEstimate": 23,
      "funding": [
    {
      "date": "2015-08-10",
      "type": "Seed",
      "amount": "175000"
    }
      ],
      "entryPoint": null,
      "contactNumber": null,
      "contactEmail": null,
      "parentCompany": "Verbit",
      "actualRevenue": 4400000,
      "founders": [
    {
      "name": "David Tohn",
      "type": "Person",
      "image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0StoUs5kpB6zZ%7C%40i3.p%3F%5B%3FOg%3Cg7S.D%5C1UyHPvU2KkBbwFn-AO%3ETh",
      "types": [
      "Person"
      ],
      "summary": "CEO at BTS Software Solutions",
      "diffbotUri": "http://diffbot.com/entity/E8f2I-t28ORGhUcN350rOmQ",
      "targetDiffbotId": "E8f2I-t28ORGhUcN350rOmQ"
    },
    {
      "name": "Ellyn Sheffield",
      "type": "Person",
      "image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7guSasZ.%3AXqGm%7CU1Dgq%5B%7BGQ8_.%7Dg6%5E-v%7DzCLte7hU4aQr8Q%2FPf%2F%5D%7ELK%3B%5Cr%3Bi%3APiGmT5JF2JXdgKcYpo%3EWtBk.MlA",
      "types": [
      "Person"
      ],
      "summary": "CEO at Verb8tm",
      "diffbotUri": "http://diffbot.com/entity/ECL79jGfFPkCljpGj4VpMzQ",
      "targetDiffbotId": "ECL79jGfFPkCljpGj4VpMzQ"
    }
      ],
      "ceo": "Ellyn Sheffield",
      "ukCompaniesHouseIds": null,
      "subsidiaries": null,
      "ukPersonsWithSignificantControl": [],
      "shareholdersList": [],
      "locations": 1,
      "topics": [],
      "diversityCertifications": ["People With Disability"],
      "dunsNumber": 7433850604,
      "versionDate": "2023-11-14T15:30:29.681Z"
    }
  ]
}

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

{
  "companyName": "Verb8tm",
    "page": 1,
    "filters": {
      "dunsNumber": [7433850604]
    },
    "fields": []
}

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.

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.

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.

{
  "meta": {
  "totalItems": 1,
  "currentPage": 1,
  "totalPages": 1,
  "itemsPerPage": 50
},
  "data": [
    {
      "marketId": "655392957a1cddf2d913acbb",
      "domain": "verb8tm.com",
      "logoURL": "https://logo.clearbit.com/verb8tm.com",
      "name": "Verb8tm",
      "description": "Provider of a media conversion platform designed to help clients with captions and transcripts at the low prices. The company's media conversion platform offers a technology-based captioning tool that provides file transcripts as a formatted file for a captioned video within 4 hours of file delivery, enabling clients to develop new and innovative products that saves time and money.",
      "foundedYear": 2015,
      "totalFundingAmount": 175000,
      "hqAddress": "6600 York Road, Baltimore, 21212, Maryland, USA",
      "hqCity": "Baltimore",
      "hqState": "Maryland",
      "hqCountry": "United States",
      "hqLat": 39.319732666015625,
      "hqLng": -76.6495361328125,
      "size": {
      "value": "10-50",
      "sortValue": 1
    },
      "fundingRounds": 1,
      "IPODate": null,
      "revenue": {
      "value": "$1M-$10M",
      "sortValue": 1
    },
      "linkedInHandle": "company/10196327",
      "twitterHandle": "verb8tm",
      "isStarredByForestreet": false,
      "momentum": {
      "funding": null,
      "webTraffic": 84,
      "mediaAnalysis": 30,
      "newsSentiment": null,
      "revenueEstimates": 30
    },
      "overallMomentum": 40,
      "professionalEmployeeEstimate": 23,
      "funding": [
    {
      "date": "2015-08-10",
      "type": "Seed",
      "amount": "175000"
    }
      ],
      "entryPoint": null,
      "contactNumber": null,
      "contactEmail": null,
      "parentCompany": "Verbit",
      "actualRevenue": 4400000,
      "founders": [
    {
      "name": "David Tohn",
      "type": "Person",
      "image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0StoUs5kpB6zZ%7C%40i3.p%3F%5B%3FOg%3Cg7S.D%5C1UyHPvU2KkBbwFn-AO%3ETh",
      "types": [
      "Person"
      ],
      "summary": "CEO at BTS Software Solutions",
      "diffbotUri": "http://diffbot.com/entity/E8f2I-t28ORGhUcN350rOmQ",
      "targetDiffbotId": "E8f2I-t28ORGhUcN350rOmQ"
    },
    {
      "name": "Ellyn Sheffield",
      "type": "Person",
      "image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7guSasZ.%3AXqGm%7CU1Dgq%5B%7BGQ8_.%7Dg6%5E-v%7DzCLte7hU4aQr8Q%2FPf%2F%5D%7ELK%3B%5Cr%3Bi%3APiGmT5JF2JXdgKcYpo%3EWtBk.MlA",
      "types": [
      "Person"
      ],
      "summary": "CEO at Verb8tm",
      "diffbotUri": "http://diffbot.com/entity/ECL79jGfFPkCljpGj4VpMzQ",
      "targetDiffbotId": "ECL79jGfFPkCljpGj4VpMzQ"
    }
      ],
      "ceo": "Ellyn Sheffield",
      "ukCompaniesHouseIds": null,
      "subsidiaries": null,
      "ukPersonsWithSignificantControl": [],
      "shareholdersList": [],
      "locations": 1,
      "topics": [],
      "diversityCertifications": ["People With Disability"],
      "dunsNumber": 7433850604,
      "versionDate": "2023-11-14T15:30:29.681Z"
    }
  ]
}