CB Insights: Cbinsights Post V2 Firmographics

Search private and public company profiles by keyword, industry, location, investor, business model or ticker identifiers.

Tool ID: cbinsights_post_v2_firmographics

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'cbinsights_post_v2_firmographics',
  {
    "awardsAndSpotlightsIds": [
      123
    ]
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute cbinsights_post_v2_firmographics --input '{
  "awardsAndSpotlightsIds": [
    123
  ]
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "nextPageToken": "example",
    "orgs": [
      {
        "businessModels": [
          {}
        ],
        "childOrgs": [
          {}
        ],
        "competitors": [
          {}
        ]
      }
    ],
    "totalHits": 123
  }
}

Use deepline describe cbinsights_post_v2_firmographics --json for the latest machine-readable contract.

Input reference

Search parameters to request a list of organization profiles. You must pass at least one search parameter.

Name	Type	Required	Default	Details
`payload.awardsAndSpotlightsIds`	`array`	No	—	Searches for organizations that are a part of the specified awards and spotlights IDs. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/awards-and-spotlights Minimum items: 1.
`payload.businessModelIds`	`array`	No	—	Searches for organizations that are a part of the specified business model IDs. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/business-models Minimum items: 1.
`payload.ciks`	`array`	No	—	SEC Central Index Keys of organizations to match. Minimum items: 1.
`payload.cityIds`	`array`	No	—	CBI city IDs to match. See https://api-docs.cbinsights.com/docs/reference/address/ Minimum items: 1.
`payload.collectionIds`	`array`	No	—	Searches for organizations within these Expert Collections. Minimum items: 1.
`payload.continentIds`	`array`	No	—	CBI continent IDs to match. See https://api-docs.cbinsights.com/docs/reference/address/ Minimum items: 1.
`payload.countryIds`	`array`	No	—	CBI country IDs to match. See https://api-docs.cbinsights.com/docs/reference/address/ Minimum items: 1.
`payload.cusips`	`array`	No	—	CUSIPs (Committee on Uniform Security Identification Procedures - North American security identifiers) to match. Minimum items: 1.
`payload.figis`	`array`	No	—	Financial Instrument Global Identifiers (also known as OpenFIGI) to match. Minimum items: 1.
`payload.fundingInvestorTypeIds`	`array`	No	—	Searches for organizations which have been invested in by these investor types. See https://api-docs.cbinsights.com/docs/reference/investor_type/ Minimum items: 1.
`payload.industryIds`	`array`	No	—	CBI industry IDs to match. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries Minimum items: 1.
`payload.investorOrgIds`	`array`	No	—	Searches for organizations which have been invested in by these investors. Minimum items: 1.
`payload.investorTypeIds`	`array`	No	—	Searches for investor organizations with these investor types. See https://api-docs.cbinsights.com/docs/reference/investor_type/ Minimum items: 1.
`payload.isins`	`array`	No	—	International Securities Identification Numbers to match. Minimum items: 1.
`payload.keyword`	`string`	No	—	Analogous to keyword search on the CB Insights platform. Search term to match against organization names, descriptions, and aliases. Has partial and fuzzy matching. e.g., “robo” will match “Robot,” “Robotics,” etc., as will “robp.” Minimum length: 1.
`payload.lastFundingRoundCategoryIds`	`array`	No	—	CBI funding round category IDs of organizations to search for. For a more granular filter, the “lastFundingRoundIds” filter can be used instead. See https://api-docs.cbinsights.com/docs/reference/funding_types/ Minimum items: 1.
`payload.lastFundingRoundIds`	`array`	No	—	CBI funding round IDs of organizations. This property is used for granular filtering of the stage that most recently occurred. For detailed mapping of Funding Round IDs to investment Stages, see: https://api-docs.cbinsights.com/docs/reference/funding_types/#funding-round Minimum items: 1.
`payload.leis`	`array`	No	—	Legal Entity Identifiers to match. Minimum items: 1.
`payload.limit`	`integer`	No	—	The maximum number of organizations to be returned in a single response.
`payload.marketIds`	`array`	No	—	Searches for organizations that are a part of these CB Insights markets. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/markets Minimum items: 1.
`payload.marketNames`	`array`	No	—	Searches for organizations that are a part of these CB Insights markets. Supports partial matches, i.e., “AI” will return organizations in markets that include “AI” in their names. Minimum items: 1.
`payload.maxCurrentHeadcount`	`integer`	No	—	Filters for organizations with a headcount less than or equal to this value
`payload.maxLastFundingDate`	`string`	No	—	Filters for organizations which have received funding on or before the provided date, in the format YYYY-MM-DD. Minimum length: 1.
`payload.maxTotalFundingInMillions`	`number`	No	—	Filters for organizations which have received a total amount of funding less than or equal to this value, in millions of US dollars.
`payload.maxValuationInMillions`	`number`	No	—	Filters for organizations with a valuation less than or equal to this value, in millions of US dollars.
`payload.minCurrentHeadcount`	`integer`	No	—	Filters for organizations with a headcount greater than or equal to this value
`payload.minLastFundingDate`	`string`	No	—	Filters for organizations which have received funding on or after the provided date, in the format YYYY-MM-DD. Minimum length: 1.
`payload.minTotalFundingInMillions`	`number`	No	—	Filters for organizations which have received a total amount of funding greater than or equal to this value, in millions of US dollars.
`payload.minValuationInMillions`	`number`	No	—	Filters for organizations with a valuation greater than or equal to this value, in millions of US dollars.
`payload.nextPageToken`	`string`	No	—	Token to fetch the next page of results. provided in a previous response.
`payload.orgIds`	`array`	No	—	CB Insights organization IDs to return. Minimum items: 1.
`payload.orgNames`	`array`	No	—	Organization names to exactly match. Minimum items: 1.
`payload.orgStatusIds`	`array`	No	—	CBI organization status IDs to match. See https://api-docs.cbinsights.com/docs/reference/org_status/ Minimum items: 1.
`payload.regionIds`	`array`	No	—	CBI region IDs to match. See https://api-docs.cbinsights.com/docs/reference/address/ Minimum items: 1.
`payload.sectorIds`	`array`	No	—	CBI sector IDs to match. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries Minimum items: 1.
`payload.sort`	`object`	No	—	The order in which the results will be returned.
`payload.stateProvinceIds`	`array`	No	—	CBI state/province IDs to match. See https://api-docs.cbinsights.com/docs/reference/address/ Minimum items: 1.
`payload.subindustryIds`	`array`	No	—	CBI sub-industry IDs to match. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/industries Minimum items: 1.
`payload.technologyIds`	`array`	No	—	Searches for organizations that are a part of the specified technology IDs. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/technologies Minimum items: 1.
`payload.tickers`	`array`	No	—	Stock tickers to match. Each may optionally include a stock exchange code, separated from the ticker by a colon. See https://api-docs.cbinsights.com/docs/reference/stock_exchanges/ for exchange codes. Minimum items: 1.
`payload.urls`	`array`	No	—	Websites of organizations to search for. Has partial matching. e.g., “linkedin.com” will match “linkedin.com,” “linkedin.com/in/john-doe,” and “example-linkedin.com.” Minimum items: 1.
`payload.vcBacked`	`boolean`	No	—	Boolean flag to match organizations that have received venture funding.

This input schema is too large for an inline display. Read the complete live contract with deepline describe cbinsights_post_v2_firmographics --json.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.nextPageToken`	`string`	No	—	Token to fetch the next page of results. If the value is null, then there are no more results to page through.
`result.data.orgs`	`array`	No	—	A list of organization profiles that include general information like location, headcount, and industry, as well as proprietary data like business models, Competitor Scores, and Expert Collections.
`result.data.orgs[].businessModels`	`array`	No	—	Business models for the organization. Indicates what markets a business serves and how they create revenue.
`result.data.orgs[].businessModels[].businessModel`	`string`	No	—	The name of the business model.
`result.data.orgs[].businessModels[].businessModelId`	`integer`	No	—	The CBI ID of the business model. See https://api-docs.cbinsights.com/portal/docs/References/Taxonomy/business-models
`result.data.orgs[].childOrgs`	`array`	No	—	Information about this organization’s subsidiaries.
`result.data.orgs[].childOrgs[].name`	`string`	No	—	The name of the organization.
`result.data.orgs[].childOrgs[].orgId`	`integer`	No	—	CB Insights organization ID.
`result.data.orgs[].competitors`	`array`	No	—	Competitors that CB Insights has determined are related to the company.
`result.data.orgs[].competitors[].name`	`string`	No	—	The name of the organization.
`result.data.orgs[].competitors[].orgId`	`integer`	No	—	CB Insights organization ID.
`result.data.orgs[].competitors[].score`	`number`	No	—	The Competitor Score of this competitor.
`result.data.orgs[].expertCollections`	`array`	No	—	CB Insights analyst-curated lists of companies that this company is a part of.
`result.data.orgs[].expertCollections[].collectionId`	`integer`	No	—	The ID of the Expert Collection.
`result.data.orgs[].expertCollections[].collectionName`	`string`	No	—	Name of the Expert Collection.
`result.data.orgs[].financials`	`object`	No	—	—
`result.data.orgs[].financials.lastFundingDate`	`string`	No	—	The date of the most recent funding round, in the format YYYY-MM-DD.
`result.data.orgs[].financials.latestRevenueMultipleMax`	`number`	No	—	The latest maximum known revenue multiple.
`result.data.orgs[].financials.latestRevenueMultipleMin`	`number`	No	—	The latest minimum known revenue multiple.
`result.data.orgs[].financials.marketCap`	`number`	No	—	For public companies, the market capitalization of the organization in millions of US dollars.
`result.data.orgs[].financials.revenueDate`	`string`	No	—	The date of the most recent revenue data, in the format YYYY-MM-DD.
`result.data.orgs[].financials.revenueMax`	`number`	No	—	The latest maximum known revenue in US dollars.
`result.data.orgs[].financials.revenueMin`	`number`	No	—	The latest minimum known revenue in US dollars. For most organizations, revenueMin is equal to revenueMax.
`result.data.orgs[].financials.revenuePeriod`	`string`	No	—	The fiscal period that the latest revenue data covers. For public companies, revenue is reported for the last known full fiscal year.
`result.data.orgs[].financials.stockLastClose`	`number`	No	—	For public companies, the price, in US dollars, at which it traded at the end of the previous regular trading session.
`result.data.orgs[].financials.totalEquityFunding`	`number`	No	—	Total equity funding, in millions of US dollars. This only includes rounds where equity is exchanged.
`result.data.orgs[].financials.totalFunding`	`number`	No	—	Total funding of any type raised by this organization, in millions of US dollars. This includes Grant, Accelerator, Debt, and other non-equity rounds.
`result.data.orgs[].financials.valuation`	`number`	No	—	Latest valuation on record in millions of US dollars.
`result.data.orgs[].headcount`	`object`	No	—	—
`result.data.orgs[].headcount.currentHeadcount`	`integer`	No	—	The current headcount of this organization.
`result.data.orgs[].headcount.oneYearGrowth`	`number`	No	—	The change in this organization’s headcount over the past 12 months, expressed as a decimal offset from zero (i.e. a 12.3% increase returns 0.123, and a 45.6% decrease returns -0.456).
`result.data.orgs[].headcount.sixMonthGrowth`	`number`	No	—	The change in this organization’s headcount over the past 6 months, expressed as a decimal offset from zero (i.e. a 12.3% increase returns 0.123, and a 45.6% decrease returns -0.456).
`result.data.orgs[].headcount.twoYearGrowth`	`number`	No	—	The change in this organization’s headcount over the past 24 months, expressed as a decimal offset from zero (i.e. a 12.3% increase returns 0.123, and a 45.6% decrease returns -0.456).
`result.data.orgs[].identifiers`	`object`	No	—	—
`result.data.orgs[].identifiers.ciks`	`array`	No	—	SEC Central Index Keys.
`result.data.orgs[].identifiers.cusips`	`array`	No	—	Committee on Uniform Security Identification Procedures (North American security identifiers).
`result.data.orgs[].identifiers.figis`	`array`	No	—	Financial Instrument Global Identifiers (also known as OpenFIGI).
`result.data.orgs[].identifiers.isins`	`array`	No	—	International Securities Identification Numbers.
`result.data.orgs[].identifiers.leis`	`array`	No	—	Legal Entity Identifiers.
`result.data.orgs[].identifiers.tickers`	`array`	No	—	Stock tickers associated with this organization, not including the exchange associated with each ticker.
`result.data.orgs[].identifiers.tickersWithExchanges`	`array`	No	—	Stock tickers associated with this organization, including the exchange of each ticker, separated by a colon.
`result.data.orgs[].orgId`	`integer`	No	—	CB Insights organization ID.
`result.data.orgs[].parentOrgs`	`array`	No	—	Information about parent organization(s).
`result.data.orgs[].parentOrgs[].name`	`string`	No	—	The name of the organization.
`result.data.orgs[].parentOrgs[].orgId`	`integer`	No	—	CB Insights organization ID.
`result.data.orgs[].summary`	`object`	No	—	—
`result.data.orgs[].summary.additionalUrls`	`array`	No	—	Any additional websites the organization may have.
`result.data.orgs[].summary.address`	`object`	No	—	—
`result.data.orgs[].summary.address.city`	`string`	No	—	The name of the city in which the organization is located.

The table shows the first 50 fields. Use the live contract below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe cbinsights_post_v2_firmographics --json.

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation