Skip to content

Integrations

CB Insights

Research private markets — firmographics, funding, and predictive scores

CB Insights provides company, investor, funding, cap-table, exit, relationship, and leadership data. Use its Mosaic Score, Commercial Maturity, and Exit Probability operations to retrieve scores, supporting signals, and history. Exit Probability includes a comparable-company mean and ratio. Cap-table history includes issuance and conversion prices, liquidation preferences, participation rights, and anti-dilution terms.

Credentials and access

Obtain a client ID and secret from your CB Insights Customer Success Manager. Sim exchanges them for a short-lived bearer token automatically. Most data operations consume credits; access depends on your license for Firmographics, Financial Transactions, Business Relationships, Management and Board, Outlook, or Scouting Reports. Check your entitlements before building a workflow around a dataset.

Working with company data

Use Look Up Organizations to match names or websites to CB Insights IDs before requesting paid data. The lookup is described as credit-free by the integration's endpoint contract; confirm current credit terms with CB Insights. Multi-organization List operations accept up to 100 organizations per call.

Get Strategy Map groups connected companies by category and includes their partnerships, investments, and acquisitions. Get Scouting Report generates company analysis, Ask ChatCBI answers questions with sources, and Retrieve Context supplies structured records for another model.

When incompleteRoundType identifies a pending round, all exit probabilities are suppressed to zero; a rumored round suppresses only the matching exit type. These zeroes indicate suppression rather than low predicted probability. Multi-organization responses can omit organizations with no data; compare returned IDs with your input before processing the result.

The streaming endpoints chatcbichunked and scoutingreportstream are not exposed. Use the non-streaming operations for a complete response. A Scouting Report can take several minutes to generate.

Use the block

Look up companies, retrieve firmographic and transaction data, map business relationships, read leadership records and score history, and generate Scouting Reports or ChatCBI answers. Supply client credentials; dataset access and credit use depend on your CB Insights license.

Actions

CB Insights Look Up Organizations

Resolve company names or websites to CB Insights organization IDs. The integration contract describes lookup as credit-free; confirm current credit terms with CB Insights before requesting paid datasets.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
namesjsonNoOrganization names to look up, e.g. ["CB Insights"]
urlsjsonNoOrganization websites to look up, e.g. ["cbinsights.com"]
profileUrlstringNoA CB Insights profile URL to resolve. Mutually exclusive with names and urls — the API rejects a request that sets both.
limitnumberNoRows to return in a single response, 1-100
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
orgsjsonMatched organizations as [{orgId, name, description, aliases, urls}]
nextPageTokenstringToken for the next page, or null when there are no more results
totalHitsnumberTotal number of matching records
totalHitsRelationstringWhether totalHits is exact ('eq') or a floor ('gte', used above 10,000)

CB Insights Search Firmographics

Search profiles of private companies, public companies, and investors by market, industry, geography, headcount, funding, and valuation. Each field is ANDed together; values within a field are ORed.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
keywordstringNoSearch term matched against organization names, descriptions, and aliases
orgIdsjsonNoCB Insights organization IDs to return, e.g. [129410, 129411]
orgNamesjsonNoOrganization names to match exactly, e.g. ["CB Insights"]
urlsjsonNoOrganization websites to match, e.g. ["cbinsights.com"]
tickersjsonNoStock tickers to match, each optionally suffixed with an exchange code after a colon
marketIdsjsonNoCB Insights market IDs to match, e.g. [6, 95, 106]
marketNamesjsonNoCB Insights market names to match. Partial matches count — "AI" returns every market whose name contains it.
industryIdsjsonNoCB Insights industry IDs to match (mid level of the taxonomy)
sectorIdsjsonNoCB Insights sector IDs to match (top level of the taxonomy)
subindustryIdsjsonNoCB Insights sub-industry IDs to match (lowest level of the taxonomy)
businessModelIdsjsonNoCB Insights business model IDs to match
technologyIdsjsonNoCB Insights technology landscape IDs to match
collectionIdsjsonNoExpert Collection IDs to search within
countryIdsjsonNoCB Insights country IDs to match
stateProvinceIdsjsonNoCB Insights state or province IDs to match
cityIdsjsonNoCB Insights city IDs to match
continentIdsjsonNoCB Insights continent IDs to match
regionIdsjsonNoCB Insights region IDs to match
orgStatusIdsjsonNoCB Insights organization status IDs to match (active, acquired, dead, IPO, merged)
investorOrgIdsjsonNoReturn organizations these investor organization IDs have invested in
investorTypeIdsjsonNoReturn investor organizations of these investor types
fundingInvestorTypeIdsjsonNoReturn organizations funded by these investor types
lastFundingRoundIdsjsonNoCB Insights funding round IDs of the most recent round
lastFundingRoundCategoryIdsjsonNoCB Insights funding round category IDs of the most recent round
minCurrentHeadcountnumberNoMinimum current headcount
maxCurrentHeadcountnumberNoMaximum current headcount
minTotalFundingInMillionsnumberNoMinimum total funding raised, in millions of US dollars
maxTotalFundingInMillionsnumberNoMaximum total funding raised, in millions of US dollars
minValuationInMillionsnumberNoMinimum valuation, in millions of US dollars
maxValuationInMillionsnumberNoMaximum valuation, in millions of US dollars
minLastFundingDatestringNoEarliest date of the most recent funding round, as YYYY-MM-DD
maxLastFundingDatestringNoLatest date of the most recent funding round, as YYYY-MM-DD
vcBackedbooleanNoRestrict to organizations that have received venture funding
sortFieldstringNoSort field: orgName, orgId, lastUpdateTime, lastFundingDate, latestValuation, mosaicOverall, mosaicManagement, mosaicMarket, mosaicMomentum, mosaicMoney, headcountCurrent, headcount6MonthGrowth, headcount12MonthGrowth, or headcount24MonthGrowth
sortDirectionstringNoSort direction, "asc" or "desc"
limitnumberNoRows to return in a single response, 1-100
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
orgsjsonMatching profiles as [{orgId, summary, taxonomy, financials, headcount, identifiers, businessModels, competitors, expertCollections, parentOrgs, childOrgs}]
nextPageTokenstringToken for the next page, or null when there are no more results
totalHitsnumberTotal number of matching records
totalHitsRelationstringWhether totalHits is exact ('eq') or a floor ('gte', used above 10,000)

CB Insights Get Organization Fundings

Retrieve the funding rounds one organization has received, its cap table history, and AI-generated insights extracting the key themes of each deal.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.
limitnumberNoRows to return in a single response, 1-100
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
fundingsjsonRounds as [{dealId, date, round, roundCategory, amountInMillions, valuationInMillions, investors, insights, sources}]
capTableHistoryjsonOwnership structure as [{dealId, roundType, issuancePrice, conversionPrice, percentageOwned, sharesAuthorized, terms}]
nextPageTokenstringToken for the next page, or null when there are no more results
totalHitsnumberTotal number of matching records
totalHitsRelationstringWhether totalHits is exact ('eq') or a floor ('gte', used above 10,000)

CB Insights Get Organization Investments

Retrieve the rounds in which one organization invested in another, with AI-generated insights extracting the key themes of each deal.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.
limitnumberNoRows to return in a single response, 1-100
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
investmentsjsonRounds as [{dealId, date, round, roundCategory, amountInMillions, valuationInMillions, recipient, investors, insights, sources}]
nextPageTokenstringToken for the next page, or null when there are no more results
totalHitsnumberTotal number of matching records
totalHitsRelationstringWhether totalHits is exact ('eq') or a floor ('gte', used above 10,000)

CB Insights Get Organization Portfolio Exits

Retrieve exit rounds for companies this organization invested in before the exit, with AI-generated insights on each deal.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.

Output

ParameterTypeDescription
portfolioExitsjsonExits as [{dealId, date, round, roundCategory, amountInMillions, valuationInMillions, recipient, investors, insights, sources}]

CB Insights Get Organization Business Relationships

Retrieve one organization's partnerships, client/vendor relationships, and licensing activity, with AI-generated insights on each.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.

Output

ParameterTypeDescription
businessRelationshipsjsonRelationships as [{relationshipId, startDate, partners, insights, newsSnippet, sources, lastUpdateTime}]

CB Insights Get Organization Management and Board

Retrieve an organization's leadership team and board members with their education, work history, and board seats, plus the Management factor of its Mosaic Score.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.
titleIdsjsonNoCB Insights person title IDs to filter the people returned, e.g. [50, 75]

Output

ParameterTypeDescription
peoplejsonPeople as [{personId, givenName, middleName, surname, email, linkedInUrl, education, workExperience, boardAssociations}]
mosaicManagementnumberManagement factor of the Mosaic Score, measuring the pedigree and track record of the leadership team

CB Insights Get Organization Outlook

Retrieve an organization's current Mosaic Score, Commercial Maturity level, and two-year IPO and M&A exit probabilities, with the signals driving each.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.

Output

ParameterTypeDescription
mosaicScorejsonMosaic Score on a 0-1000 scale: {overall, management, market, momentum, money}, each with scoreValue, asOfDate, and scoreInsights
commercialMaturityjsonCommercial Maturity on a 1-5 scale: {maturityLevel: {level, stage, stageDescription, asOfDate}, commercialMaturitySignals}. Available only for a subset of companies.
exitProbabilityjsonTwo-year exit probability: {ipo, mna, exitSignals, incompleteRoundType}. A pending round zeroes the probabilities rather than omitting them.

CB Insights Get Organization Funding Window

Retrieve the estimated window in which an organization is likely to raise its next round, with the cohort it was compared against.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.

Output

ParameterTypeDescription
windowStartstringEstimated start of the next funding window, as YYYY-MM-DD
windowEndstringEstimated end of the next funding window, as YYYY-MM-DD
cohortNextRoundRatenumberShare of the cohort that historically raised another round, as a decimal between 0 and 1
cohortCriteriajsonHow the comparison cohort was defined: {cohortGeo, cohortRoundCategory, cohortLandscapes}
latestFundingjsonThe latest equity-backed round: {date, dealId}

CB Insights Get Organization Revenue

Retrieve reported and estimated revenue by calendar year for one organization, with the sources behind each figure.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.

Output

ParameterTypeDescription
orgIdnumberCB Insights organization ID
orgNamestringThe organization's name
orgUrlstringThe organization's website
revenuejsonRevenue by year as [{calendarYear, lowestValue, averageValue, highestValue, isActual, reportedMetric, yoyGrowthPercent, sources}]

CB Insights Get Mosaic History

Retrieve an organization's historical Mosaic Scores — overall plus the management, market, momentum, and money factors — so a trend can be read rather than a single snapshot.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.
startDatestringNoEarliest date to return, as YYYY-MM-DD. Must be on or after 2024-01-01 and within the last 24 months. Defaults to the later of one year ago and 2024-01-01.

Output

ParameterTypeDescription
overalljsonOverall Mosaic Score over time as [{asOfDate, scoreValue}]
managementjsonManagement factor over time as [{asOfDate, scoreValue}]
marketjsonMarket factor over time as [{asOfDate, scoreValue}]
momentumjsonMomentum factor over time as [{asOfDate, scoreValue}]
moneyjsonMoney factor over time as [{asOfDate, scoreValue}]

CB Insights Get Commercial Maturity History

Retrieve an organization's historical Commercial Maturity levels, tracking how its ability to compete for customers or serve as a partner has moved over time.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.
startDatestringNoEarliest date to return, as YYYY-MM-DD. Must be on or after 2024-07-25 and within 24 months of endDate. Defaults to the later of one year ago and 2024-07-25.
endDatestringNoLatest date to return, as YYYY-MM-DD. Must be on or after 2024-07-25 and within 24 months of startDate. Defaults to today.

Output

ParameterTypeDescription
commercialMaturityHistoryjsonMaturity levels over time as [{asOfDate, level, stage, stageDescription}], where level runs 1-5

CB Insights Get Exit Probability History

Retrieve an organization's historical two-year IPO and M&A exit probabilities, each alongside the mean for comparable companies.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.
startDatestringNoEarliest date to return, as YYYY-MM-DD. Must be on or after 2025-02-25 and within 24 months of endDate. Defaults to the later of one year ago and 2025-02-25.
endDatestringNoLatest date to return, as YYYY-MM-DD. Must be on or after 2025-02-25 and within 24 months of startDate. Defaults to today.

Output

ParameterTypeDescription
ipojsonIPO probability over time as [{asOfDate, exitProbability, meanProbability, ratioToMean}]
mnajsonM&A probability over time as [{asOfDate, exitProbability, meanProbability, ratioToMean}]
incompleteRoundTypestringAn in-progress round, if any. A pending round zeroes every probability; a rumored round zeroes only the matching exit type.

CB Insights Get Strategy Map

Retrieve the companies related to an organization, grouped into industry categories, with the relationships, investments, and acquisitions that connect them.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.

Output

ParameterTypeDescription
orgNamestringThe organization's name
logoUrlstringURL of the organization's logo
categoriesjsonIndustry categories as [{name, companies: [{orgId, name, logoUrl, connections: {businessRelationships, investments, acquisitions}}]}]

CB Insights Get Scouting Report

Generate an AI-written Scouting Report on a private company covering its business model, market position, strengths, and opportunities. Only active companies are eligible, and generation can take several minutes.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdnumberYesCB Insights organization ID of an active company. Resolve a name or website to one with Look Up Organizations, before requesting company data; confirm current credit terms with CB Insights.

Output

ParameterTypeDescription
orgInfojsonFirmographics and proprietary scores for the company: {id, name, url, description, foundedYear, headcount, address, stage, totalFunding, lastFundingDate, overallMosaicScore, commercialMaturity}
reportMarkdownstringThe Scouting Report as Markdown, including citations
reportJsonstringThe Scouting Report as a JSON string. Citation links are not included in this form — use reportMarkdown when they matter.

CB Insights List Fundings

Retrieve funding rounds and cap table history for up to 100 organizations at once, with AI-generated insights extracting the key themes of each deal.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]
limitnumberNoRows to return in a single response, 1-100
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, fundings, capTableHistory}]. An organization with no data is omitted from the response.
nextPageTokenstringToken for the next page, or null when there are no more results
totalHitsnumberTotal number of matching records
totalHitsRelationstringWhether totalHits is exact ('eq') or a floor ('gte', used above 10,000)

CB Insights List Investments

Retrieve the rounds up to 100 organizations participated in as investors, with AI-generated insights extracting the key themes of each deal.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]
limitnumberNoRows to return in a single response, 1-100
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, investments}]. An organization with no data is omitted from the response.
nextPageTokenstringToken for the next page, or null when there are no more results
totalHitsnumberTotal number of matching records
totalHitsRelationstringWhether totalHits is exact ('eq') or a floor ('gte', used above 10,000)

CB Insights List Portfolio Exits

Retrieve exit rounds for companies up to 100 organizations invested in before the exit, with AI-generated insights on each deal.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]
limitnumberNoRows to return in a single response, 1-100
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, portfolioExits}]. An organization with no data is omitted from the response.
nextPageTokenstringToken for the next page, or null when there are no more results
totalHitsnumberTotal number of matching records
totalHitsRelationstringWhether totalHits is exact ('eq') or a floor ('gte', used above 10,000)

CB Insights List Business Relationships

Retrieve partnerships, client/vendor relationships, and licensing activity for up to 100 organizations at once, with AI-generated insights on each.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]
nextPageTokenstringNoContinuation token from a previous response; omit for the first page

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, businessRelationships}]
nextPageTokenstringToken for the next page, or null when there are no more results

CB Insights List Management and Board

Retrieve leadership teams, board members, and the Management factor of the Mosaic Score for up to 100 organizations at once.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]
titleIdsjsonNoCB Insights person title IDs to filter the people returned, e.g. [50, 75]

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, managementAndBoard: {mosaicManagement, people}}]. An organization with no data is omitted from the response.

CB Insights List Outlook

Retrieve Mosaic Score, Commercial Maturity, and Exit Probability for up to 100 organizations at once.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, mosaicScore, commercialMaturity, exitProbability}]. An organization with no data is omitted from the response.

CB Insights List Funding Windows

Retrieve the estimated next-round funding window for up to 100 organizations at once, with the cohort each was compared against.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, windowStart, windowEnd, cohortNextRoundRate, cohortCriteria, latestFunding}]. An organization with no data is omitted from the response.

CB Insights List Revenue

Retrieve reported and estimated revenue by calendar year for up to 100 organizations at once.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
orgIdsjsonYesCB Insights organization IDs, 1-100 per request, e.g. [129410, 1034157]

Output

ParameterTypeDescription
orgsjsonOrganizations as [{orgId, orgName, orgUrl, revenue}]. An organization with no data is omitted from the response.

CB Insights Chat

Ask ChatCBI a question in natural language and get an answer grounded in CB Insights data, with its sources and suggested follow-ups. Uses generative AI and can be wrong — verify anything that matters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
messagestringYesThe question to ask, e.g. "Which emerging technology markets are seeing the highest equity funding growth right now?"
chatIdstringNoConversation ID returned by a previous call. Pass it to continue that conversation rather than starting a new one.

Output

ParameterTypeDescription
chatIdstringConversation ID. Pass it back as chatId to continue this conversation.
titlestringTitle CB Insights gave the conversation
messagestringChatCBI's answer, as Markdown
sourcesjsonSources behind the answer as [{sourceIndex, result: {title, url, date, thumbnailUrl}}]
relatedContentjsonRelated references as [{title, url, date, thumbnailUrl}]
suggestionsjsonSuggested follow-up questions

CB Insights Retrieve Context

Retrieve the raw structured CB Insights data relevant to a question, for feeding your own model rather than reading a written answer. Uses generative AI and can be wrong — verify anything that matters.

Inputs and outputs

Input

ParameterTypeRequiredDescription
clientIdstringYesCB Insights API client ID, exchanged for a bearer token before each call
clientSecretstringYesCB Insights API client secret, exchanged for a bearer token before each call
messagestringYesThe question to retrieve context for. Must be under 10,000 characters.

Output

ParameterTypeDescription
datastringRetrieved records as a JSON string, keyed by source (companySearch, dealSearch, markets, scoutingReports, businessRelationships, revenue, investments, and others)
guidancejsonNotes describing what each returned data source contains
Was this helpful?
Suggest an edit