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