Demandbase
App · 24 actions
Find and enrich companies and contacts with Demandbase, read account intent, manage keyword sets, watch companies and people for changes, and export accounts with their journey stage and engagement.
Actions
| Action | What it does |
|---|---|
| Create keyword set | Create a keyword set to measure intent against, with its keywords and any web pages Demandbase should draw more keywords from. |
| Create subscription | Start watching companies, their news, their family trees or people for changes. |
| Delete subscription | Delete a subscription, which stops its checks and alerts for good. |
| Export account lists | Export every account list with its id, or the accounts in the lists you give. |
| Get company | Get a company's firmographics: industry, revenue, employees, address, phone, codes, websites and social profiles, with its family tree, competitors, logos or installed technology if you ask. |
| Get company intent | Find which companies are researching your keywords: for each, the keyword, intent strength, how many people are researching it, and whether it is trending, week by week. |
| Get company news | Get recent news about a company, such as leadership changes, funding or acquisitions, from all categories or the ones you pick. |
| Get contact | Get a person's job, email addresses, phone numbers, job level and function, and social profiles, by their contact id. |
| Get credit usage | See how many B2B API credits your Demandbase account has, has used and has left. |
| Get export job | Check an export: accepted, processing, finished or failed, and once finished the link to download its file, which works for 24 hours. |
| Get subscription | Get a subscription's settings: what it watches, how often it checks, when it next checks and its webhook. |
| Get subscription alert | Get what changed in one alert: for each company or person, the fields that changed, or the news articles and their categories, or the companies added to a family tree. |
| Get subscription job | Check a job that creates or changes a subscription: accepted, processing, finished or failed, the subscription's id once known, and any ids Demandbase didn't recognize. |
| List export jobs | List the exports started for your Demandbase account, newest first, with their status. |
| List keyword sets | List the keyword sets intent is measured against, with their ids. |
| List keywords in a set | List one page of a keyword set's keywords. |
| List subscription alerts | List the alerts a subscription has made, newest first: one for each check that found changes. |
| List subscriptions | List your Demandbase subscriptions, which watch companies, people or company news for changes. |
| Match company | Find the company, and the person if you give one, that a name, website, work email or LinkedIn handle belongs to: the way to enrich a lead or a CRM record. |
| Search companies | Find companies in Demandbase's database by name, website, country, industry, size, revenue and more. |
| Search contacts | Find people by name, job title, level or function, at given companies or a company's website, by country or industry. |
| Start export | Export your Demandbase accounts, people, opportunities or activities with the fields you pick, such as an account's journey stage, engagement minutes and scores, to a file. |
| Update keyword set | Rename a keyword set, mark it competitive or not, or add and remove keywords and seed pages. |
| Update subscription | Add or remove the companies or people a subscription watches, or change its name, frequency, fields, news categories or webhook. |
Create keyword set
Create a keyword set to measure intent against, with its keywords and any web pages Demandbase should draw more keywords from. Needs the Intent API.
Inputs
- Name
nametextRequired - The keyword set's name, which must be new.
- Keywords
keywordslist - The keywords, one per row, such as zero trust.
- Seed pages
seed_urlslist - Web pages, one https address per row, that Demandbase reads to suggest up to 100 more keywords.
- Competitive
is_competitortrue/false - Mark the set as about competitors.
Outputs
keyword_setobject- The new keyword set
Example output
{
"keyword_set": {
"createdAt": "2026-08-20T09:14:22Z",
"id": 9427,
"isCompetitor": false,
"keywords": [
{
"createdAt": "2026-08-20T09:14:22Z",
"id": 551201,
"keyword": "zero trust",
"updatedAt": "2026-08-20T09:14:22Z"
}
],
"name": "Cloud Security Vendors",
"seedUrls": [
{
"createdAt": "2026-08-20T09:14:22Z",
"id": 8801,
"seedUrl": "https://example.com/security"
}
],
"updatedAt": "2026-08-20T09:20:41Z"
}
}Create subscription
Start watching companies, their news, their family trees or people for changes. Demandbase sets it up in a job: its subscription id comes from 'Get subscription job' once the job finishes. Needs the B2B API.
Inputs
- Name
nametextRequired - A name to know the subscription by.
- Watch for
subscription_typetextRequired - What the subscription watches.One of:
company(Company changes),companyNews(Company news),dbPerson(Person changes),companyFamilyTree(Company family tree changes). - Company IDs
company_idslist - The companies to watch, one Demandbase company id per row. For a family tree, give each tree's top parent company.Only when Watch for is Company changes, Company news or Company family tree changes.
- Person IDs
person_idslist - The people to watch, one Demandbase person id (dbPersonId) per row, from 'Search contacts'.Only when Watch for is Person changes.
- Check every
frequency_everynumber - How many of the unit to wait between checks, such as 7 for every 7 days. The shortest is 1 day for companies and people, 15 minutes for news and 1 week for family trees.At least 1.
- Unit
frequency_unittext - The unit of 'Check every'. Defaults to days.One of:
d(Days),w(Weeks),m(Months),h(Hours),M(Minutes). - Start date
start_datedate - When to start. The first check is one frequency after it.
- Company fields to watch
company_fieldslist - Alert when any of these change. Leave empty to watch every field.Only when Watch for is Company changes. One or more of:
all(Any field),name,activeStatus(Active status),companyStatus(Company status),companyType(Company type),businessStructure(Business structure),revenue,revenueRange(Revenue range),employees,employeeRange(Employee range), and 12 more. - Person fields to watch
person_fieldslist - Alert when any of these change, such as a new job. Leave empty to watch every field.Only when Watch for is Person changes. One or more of:
all(Any field),newEmployment(New job),titles(Job titles),active(Still in the job),name,email,phone,executiveMobileNo(Mobile number),linkedInHandle(LinkedIn),twitterHandle(X (Twitter)), and 6 more. - News categories
news_categorieslist - Only alert on news in these categories. Leave empty for every category.Only when Watch for is Company news. One or more of:
LEADERSHIP_CHANGES(Leadership Changes),NEW_OFFERINGS(New Offerings),ACQUISITIONS,PARTNERSHIPS,EXPANDING_OPERATIONS(Expanding Operations),COST_CUTTING(Cost Cutting),OUTPERFORMING,UNDERPERFORMING,COMPANY_PRESENTATION(Company Presentation),LITIGATION, and 8 more. - Description
descriptiontext - What the subscription is for.
- Webhook address
webhook_urltext - An https address of your own for Demandbase to post each alert to. It must answer Demandbase's check first. Leave empty to read alerts in Lodol instead.
- Signing secret
signing_secrettext - A secret Demandbase signs each webhook post with, up to 500 characters.
Outputs
jobobject- The job Demandbase runs the change in. Its subscriptionId is filled in once the job finishes; read it with 'Get subscription job'.
Example output
{
"job": {
"createdAt": "2026-11-02T09:00:42.620Z",
"invalidIds": [],
"jobId": "39ddf756-c04e-465c-b8c1-8d2c2be0abed",
"jobStatus": "accepted",
"jobType": "notificationSubscriptionCreate",
"message": "",
"subscriptionId": "",
"subscriptionType": "company",
"totalEntitiesProcessed": 2
}
}Delete subscription
Delete a subscription, which stops its checks and alerts for good. Needs the B2B API.
Inputs
- Subscription
subscription_idtextRequired - The subscription. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
messagetext- What Demandbase said
subscription_idtext- The subscription deleted
Example output
{
"deleted": true,
"message": "Subscription deleted successfully",
"subscription_id": "63914a27-a5ca-4fdf-80b0-ffc985f53c14"
}Export account lists
Export every account list with its id, or the accounts in the lists you give. Demandbase builds the file in a job: get its link with 'Get export job'. Needs the Data Export API.
Inputs
- Account list IDs
account_list_idslist - Lists whose accounts to export, one id per row. Leave empty to export every list instead.
- Export name
job_nametext - A name for the export. Defaults to Lodol account lists export.
Outputs
jobobject- The export job. Follow it with 'Get export job' until it is finished.
Example output
{
"job": {
"createdAt": "2026-11-02T16:43:57.378Z",
"entityType": "accountlist",
"jobId": "dcb34525-2baa-4f54-8c11-9e6175ecbc74",
"jobName": "Lodol account lists export",
"jobStatus": "accepted"
}
}Get company
Get a company's firmographics: industry, revenue, employees, address, phone, codes, websites and social profiles, with its family tree, competitors, logos or installed technology if you ask. Needs the B2B API; uses one credit.
Inputs
- Company ID
company_idtextRequired - The Demandbase company id, digits such as 726263, from 'Search companies', 'Match company' or an earlier step.
- Also get
includelist - Extra details to add.One or more of:
familytree(Family tree),competitors,installedtech(Installed technology),logos.
Outputs
companyobject- The company. Extra details asked for come as familyTree, competitors, logos and techUsed.
Example output
{
"company": {
"address": {
"city": "Redmond",
"country": "US",
"latitude": "47.64",
"longitude": "-122.13",
"state": "WA",
"street": "100 Example Way",
"zip": "98052"
},
"businessStructure": "Global Parent",
"classification": {
"primaryBusiness": {
"industry": "Computer Software",
"industryCode": "8"
},
"secondaryBusinesses": [
{
"industry": "Computer Software",
"industryCode": "8",
"subIndustry": "Enterprise Resource Planning Software",
"subIndustryCode": "8_32"
}
]
},
"companyId": 726263,
"companyName": "Example Software Inc.",
"companyStatus": "Operating",
"companyType": "Public",
"employeeCount": 12800,
"financialYearEnd": "6",
"foundedIn": "1995",
"naics": "5132",
"naicsDescription": "Software Publishers",
"phone": "+1 425 555 0100",
"revenue": 2450,
"revenueCurrency": "USD",
"sic": "7371",
"sicDescription": "Services-Computer Programming Services",
"siteCount": 41,
"siteLocationCount": 12,
"socialHandles": {
"blog": "https://example.com/blog",
"facebook": "https://www.facebook.com/example",
"linkedIn": "https://www.linkedin.com/company/example",
"twitter": "https://twitter.com/example"
},
"tickers": [
{
"exchange": "NASD",
"tickerName": "EXSW"
}
],
"websites": [
"https://www.example.com/"
]
}
}Get company intent
Find which companies are researching your keywords: for each, the keyword, intent strength, how many people are researching it, and whether it is trending, week by week. Look up by keyword set, keywords or company. Needs the Intent API (in beta).
Inputs
- From
start_datedateRequired - The first day to look at.
- To
end_datedateRequired - The last day to look at, at most 12 months after 'From'.
- Keyword sets
keyword_set_idslist - Up to 10 keyword sets to look up intent for.
- Keywords
keywordslist - Up to 50 keywords, one per row, such as zero trust.
- Company IDs
company_idslist - Up to 10 Demandbase company ids, one per row, to look up intent for.
- Intent strength
intent_strengthtext - Only signals of this strength. Leave empty for every strength.One of:
HIGH,MED(Medium),LOW. - Fewest people researching
min_people_researchingnumber - Only signals with at least this many people researching.At least 0.
- Most people researching
max_people_researchingnumber - Only signals with at most this many people researching.At least 0.
- Sort by
sort_bytext - What to sort the signals by.One of:
endDate(Period end (default)),startDate(Period start),intentStrength(Intent strength),numPeopleResearching(People researching),trendingScore(Trending score). - Order
sort_ordertext - Descending unless you choose.One of:
DESC(Descending (default)),ASC(Ascending). - Most signals
page_sizenumber - How many signals to return, 1 to 100. Defaults to 25.From 1 to 100.
Outputs
signalslist- One per company, keyword and week
total_countnumber- How many signals match, which may be more than were returned
Example output
{
"signals": [
{
"companyId": "726263",
"domain": "example.com",
"endDate": "2026-11-01",
"intentStrength": "HIGH",
"isTrending": true,
"keyword": "zero trust",
"keywordSetId": 9427,
"keywordSetName": "Cloud Security Vendors",
"numPeopleResearching": 8,
"numTrendingDays": 3,
"startDate": "2026-10-26",
"trendingScore": 10
}
],
"total_count": 1
}Get company news
Get recent news about a company, such as leadership changes, funding or acquisitions, from all categories or the ones you pick. Needs the B2B API; uses one credit.
Inputs
- Company ID
company_idtextRequired - The Demandbase company id, digits such as 726263, from 'Search companies', 'Match company' or an earlier step.
- Categories
categorieslist - Only news in these categories. Leave empty for all news.One or more of:
LEADERSHIP_CHANGES(Leadership Changes),NEW_OFFERINGS(New Offerings),ACQUISITIONS,PARTNERSHIPS,EXPANDING_OPERATIONS(Expanding Operations),COST_CUTTING(Cost Cutting),OUTPERFORMING,UNDERPERFORMING,COMPANY_PRESENTATION(Company Presentation),LITIGATION, and 8 more. - Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 50. Defaults to 10.From 1 to 50.
Outputs
articleslist- The news articles, newest first
company_idtext- The company's id
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
total_countnumber- How many there are in all, across every page
Example output
{
"articles": [
{
"imageUrl": "https://news.example.com/cmo.jpg",
"newsCategory": "LEADERSHIP_CHANGES",
"publicationDate": "2026-11-01T14:00:00Z",
"source": "Example Newswire",
"title": "Example Software names a new chief marketing officer",
"url": "https://news.example.com/example-software-cmo"
}
],
"company_id": "726263",
"page": 1,
"page_size": 10,
"total_count": 1
}Get contact
Get a person's job, email addresses, phone numbers, job level and function, and social profiles, by their contact id. Needs the B2B API; uses one credit.
Inputs
- Contact ID
contact_idtextRequired - The Demandbase contact id, from 'Search contacts' or 'Match company'.
- Include other jobs
include_other_jobstrue/false - Also list the person's other jobs.
Outputs
contactobject- The person and their job
Example output
{
"contact": {
"dbPersonDetails": {
"firstName": "Jamie",
"lastName": "Taylor",
"mobileNumber": "+1 206 555 0142",
"socialHandles": {
"linkedIn": "https://www.linkedin.com/in/jamie-taylor-example",
"twitter": "https://twitter.com/jamietaylor"
}
},
"employmentDetails": {
"companyId": 726263,
"companyName": "Example Software Inc.",
"contactId": 17864319,
"contactQualityScore": "A",
"emails": [
{
"email": "jamie.taylor@example.com",
"validationStatus": "VALID"
}
],
"jobFunctions": [
{
"id": "14",
"name": "Marketing"
}
],
"jobLevels": [
{
"id": "3",
"name": "Vice President"
}
],
"lastValidatedDate": "Aug 15, 2026",
"phoneNumbers": {
"corporateNumber": "+1 425 555 0100",
"directNumber": "+1 425 555 0111"
},
"titles": [
"Vice President, Marketing"
]
}
}
}Get credit usage
See how many B2B API credits your Demandbase account has, has used and has left.
Inputs
None.
Outputs
usageobject- The account's B2B API credits
Example output
{
"usage": {
"chargingModel": "perRecord",
"scope": "lifetime",
"totalCreditsAllocated": 50000,
"totalCreditsAvailable": 49885,
"totalCreditsConsumed": 115
}
}Get export job
Check an export: accepted, processing, finished or failed, and once finished the link to download its file, which works for 24 hours. Needs the Data Export API.
Inputs
- Job ID
job_idtextRequired - The job's id, from the step that started it.
Outputs
finishedtrue/false- Whether it is finished
jobobject- The export job
results_urltext- The file's download link, valid for 24 hours; empty until finished
results_urlslist- Every file's link, for exports of several files
statustext- accepted, processing, finished or failed
Example output
{
"finished": true,
"job": {
"createdAt": "2026-11-02T16:43:57.378Z",
"entityType": "account",
"jobId": "dcb34525-2baa-4f54-8c11-9e6175ecbc74",
"jobName": "Lodol account export",
"jobStatus": "finished",
"message": "",
"resultsUrl": "https://d3sp479zadslli.cloudfront.net/apps/data-access-proxy/uapi/1017/export.json",
"updatedAt": "2026-11-02T16:46:25.307Z"
},
"results_url": "https://d3sp479zadslli.cloudfront.net/apps/data-access-proxy/uapi/1017/export.json",
"results_urls": [
"https://d3sp479zadslli.cloudfront.net/apps/data-access-proxy/uapi/1017/export.json"
],
"status": "finished"
}Get subscription
Get a subscription's settings: what it watches, how often it checks, when it next checks and its webhook. Needs the B2B API.
Inputs
- Subscription
subscription_idtextRequired - The subscription. Pick one, or give its id from an earlier step.
Outputs
subscriptionobject- The subscription
Example output
{
"subscription": {
"createdAt": "2026-11-02T09:02:56.994Z",
"description": "Changes at our tier 1 accounts",
"fields": [
"revenue",
"employees"
],
"frequency": "1d",
"name": "Target account changes",
"newsCategories": [],
"nextFireTime": "2026-11-03T00:00:00.000Z",
"startDate": "2026-11-02",
"subscriptionId": "63914a27-a5ca-4fdf-80b0-ffc985f53c14",
"subscriptionType": "company",
"webhook": {
"disableReasonMessage": "",
"status": "ACTIVE",
"url": "https://hooks.example.com/demandbase"
}
}
}Get subscription alert
Get what changed in one alert: for each company or person, the fields that changed, or the news articles and their categories, or the companies added to a family tree. Needs the B2B API.
Inputs
- Subscription
subscription_idtextRequired - The subscription. Pick one, or give its id from an earlier step.
- Alert ID
alert_idtextRequired - The alert's id, from 'List subscription alerts' or the alert trigger.
- Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 5000. Defaults to 5,000.From 1 to 5000.
Outputs
alert_idtext- The alert
changeslist- One entry per company or person that changed: companyId or dbPersonId with the fields that changed, or a news article's articleUrl, timestamp and newsCategories, or companyFamilyTreeChanges
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
subscription_idtext- The subscription
subscription_typetext- company, companyNews, dbPerson or companyFamilyTree
total_countnumber- How many there are in all, across every page
total_pagesnumber- How many pages there are
Example output
{
"alert_id": "364559",
"changes": [
{
"companyId": "726263",
"fields": [
"revenue",
"employees"
]
}
],
"page": 1,
"page_size": 5000,
"subscription_id": "63914a27-a5ca-4fdf-80b0-ffc985f53c14",
"subscription_type": "company",
"total_count": 1,
"total_pages": 1
}Get subscription job
Check a job that creates or changes a subscription: accepted, processing, finished or failed, the subscription's id once known, and any ids Demandbase didn't recognize. Needs the B2B API.
Inputs
- Job ID
job_idtextRequired - The job's id, from the step that started it.
Outputs
jobobject- The job
Example output
{
"job": {
"createdAt": "2026-11-02T09:00:42.620Z",
"invalidIds": [],
"jobId": "39ddf756-c04e-465c-b8c1-8d2c2be0abed",
"jobStatus": "finished",
"jobType": "notificationSubscriptionCreate",
"message": "",
"subscriptionId": "63914a27-a5ca-4fdf-80b0-ffc985f53c14",
"subscriptionType": "company",
"totalEntitiesProcessed": 2
}
}List export jobs
List the exports started for your Demandbase account, newest first, with their status. Needs the Data Export API.
Inputs
- Records
entity_typetext - Only exports of this kind.One of:
All(Every kind (default)),account(Accounts),person(People),opportunity(Opportunities),activity(Activities),accountList(Account lists),campaign(Campaigns),creative(Creatives),accountBuyingGroup(Account buying groups),personBuyingGroupMember(Buying group members),sourceAccount(Source accounts). - Status
job_statustext - Only exports with this status.One of:
All(Any status (default)),accepted,processing,finished,failed. - Order
sorttext - Newest or oldest first.One of:
descending(Newest first (default)),ascending(Oldest first). - Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 100. Defaults to 10.From 1 to 100.
Outputs
jobslist- The export jobs
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
total_countnumber- How many there are in all, across every page
Example output
{
"jobs": [
{
"createdAt": "2026-11-02T16:43:57.378Z",
"entityType": "account",
"jobId": "dcb34525-2baa-4f54-8c11-9e6175ecbc74",
"jobName": "Lodol account export",
"jobStatus": "finished",
"updatedAt": "2026-11-02T16:46:25.307Z"
}
],
"page": 1,
"page_size": 10,
"total_count": 1
}List keyword sets
List the keyword sets intent is measured against, with their ids. Needs the Intent API.
Inputs
- Name contains
name_containstext - Only keyword sets whose name contains this.
- Sort by
sort_bytext - What to sort them by.One of:
createdAt(Created (default)),updatedAt(Last changed),name. - Order
sort_ordertext - Descending unless you choose.One of:
DESC(Descending (default)),ASC(Ascending). - Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 500. Defaults to 25.From 1 to 500.
Outputs
keyword_setslist- The keyword sets, without their keywords
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
total_countnumber- How many there are in all, across every page
Example output
{
"keyword_sets": [
{
"createdAt": "2026-08-20T09:14:22Z",
"id": 9427,
"isCompetitor": false,
"name": "Cloud Security Vendors",
"updatedAt": "2026-08-20T09:20:41Z"
}
],
"page": 1,
"page_size": 25,
"total_count": 1
}List keywords in a set
List one page of a keyword set's keywords. Needs the Intent API.
Inputs
- Keyword set
keyword_set_idtextRequired - The keyword set. Pick one, or give its id from an earlier step.
- Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 500. Defaults to 25.From 1 to 500.
Outputs
keyword_set_idtext- The keyword set
keywordslist- The keywords
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
total_countnumber- How many there are in all, across every page
Example output
{
"keyword_set_id": "9427",
"keywords": [
{
"createdAt": "2026-08-20T09:14:22Z",
"id": 551201,
"keyword": "zero trust",
"updatedAt": "2026-08-20T09:14:22Z"
}
],
"page": 1,
"page_size": 25,
"total_count": 1
}List subscription alerts
List the alerts a subscription has made, newest first: one for each check that found changes. Read one with 'Get subscription alert'. Needs the B2B API.
Inputs
- Subscription
subscription_idtextRequired - The subscription. Pick one, or give its id from an earlier step.
- Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 50. Defaults to 10.From 1 to 50.
Outputs
alertslist- The alerts, newest first, each with its alertId
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
subscription_idtext- The subscription
total_countnumber- How many there are in all, across every page
total_pagesnumber- How many pages there are
Example output
{
"alerts": [
{
"alertId": 364559,
"createdAt": "2026-11-03T00:05:12.202Z"
}
],
"page": 1,
"page_size": 10,
"subscription_id": "63914a27-a5ca-4fdf-80b0-ffc985f53c14",
"total_count": 1,
"total_pages": 1
}List subscriptions
List your Demandbase subscriptions, which watch companies, people or company news for changes. Needs the B2B API.
Inputs
- Kinds
subscription_typeslist - Only subscriptions of these kinds.One or more of:
company(Company changes),companyNews(Company news),dbPerson(Person changes),companyFamilyTree(Company family tree changes). - Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 50. Defaults to 10.From 1 to 50.
Outputs
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
subscriptionslist- The subscriptions
total_countnumber- How many there are in all, across every page
total_pagesnumber- How many pages there are
Example output
{
"page": 1,
"page_size": 10,
"subscriptions": [
{
"createdAt": "2026-11-02T09:02:56.994Z",
"description": "Changes at our tier 1 accounts",
"name": "Target account changes",
"subscriptionId": "63914a27-a5ca-4fdf-80b0-ffc985f53c14",
"subscriptionType": "company"
}
],
"total_count": 1,
"total_pages": 1
}Match company
Find the company, and the person if you give one, that a name, website, work email or LinkedIn handle belongs to: the way to enrich a lead or a CRM record. Needs the B2B API; uses one credit for each company or person matched.
Inputs
- Company name
company_nametext - The company's name, such as Acme Inc.
- Website
websitetext - The company's website or domain, such as acme.com.
- Work email
emailtext - A person's work email. It finds their company, and them too.
- LinkedIn handle
linkedin_handletext - A person's LinkedIn handle, the part after linkedin.com/in/.
- Stock ticker
tickertext - The company's stock ticker.
- Phone
phonetext - The company's phone number.
- Street
streettext - The company's street address.
- City
citytext - The company's city.
- State or region
statetext - The company's state or region, such as WA.
- Postal code
zip_codetext - The company's postal code.
- Country
countrytext - The company's country, by name, such as United States.
- First name
first_nametext - To match a person too: their first name.
- Last name
last_nametext - To match a person too: their last name.
- Job title
titletext - To match a person too: their job title.
- Most matches
max_resultsnumber - The most companies and people to return, 1 to 50.From 1 to 50.
Outputs
companieslist- The companies matched, best first
company_idtext- The best matching company's id, empty if none
contact_idtext- The best matching person's contact id, empty if none
contactslist- The people matched, best first
matchedtrue/false- Whether anything matched
Example output
{
"companies": [
{
"city": "Redmond",
"companyId": 726263,
"country": "United States",
"name": "Example Software Inc.",
"state": "WA",
"street": "100 Example Way"
}
],
"company_id": "726263",
"contact_id": "17864319",
"contacts": [
{
"active": true,
"companyId": 726263,
"contactId": 17864319,
"contactQualityScore": "A",
"dbPersonId": 15568398,
"firstName": "Jamie",
"lastName": "Taylor",
"title": "Vice President, Marketing"
}
],
"matched": true
}Search companies
Find companies in Demandbase's database by name, website, country, industry, size, revenue and more. Gets one page of up to 50, with each company's id for 'Get company'. Needs the B2B API; uses no credits.
Inputs
- Company name
nametext - The company's name, or part of it.
- Website
websitetext - The company's web domain, such as demandbase.com.
- Stock ticker
tickertext - The company's stock ticker, such as MSFT.
- Country
countrytext - Only companies in this country.One of:
68(Afghanistan),1(Ahvenanmaan Laani),120(Albania),109(Algeria),2(American Samoa),114(Andorra),121(Angola),3(Anguilla),4(Antarctica),5(Antigua and Barbuda), and 243 more. - State or region
statetext - A state or region code, such as CA.
- Cities
citiestext - One or more cities, separated by commas, such as San Francisco, New York.
- Industries
industrieslist - Only companies in any of these industries.One or more of:
1(Aerospace and Defense),2(Agriculture and Forestry),3(Automotive),4(Banks),5(Chemicals),6(Civic, Non-Profit and Membership Groups),7(Computer Hardware),8(Computer Software),9(Construction and Building Materials),10(Consumer Product Manufacturing), and 20 more. - Business types
business_typeslist - Only these kinds of organization.One or more of:
public,private,school,government,organization. - Company status
company_statuslist - Only companies in these states, such as Operating.One or more of:
operating,non-operating(Not operating),acquired,liquidating,outOfBusiness(Out of business),unassigned. - Fortune ranking
fortune_rankingtext - Only Fortune 500 or Fortune 1000 companies.One of:
fortune500(Fortune 500),fortune1000(Fortune 1000). - Business structure
business_structuretext - Only global parents, subsidiaries, branches and so on.One of:
globalParent(Global parent),subsidiary,branch,independent,group,uncategorized. - Regions
regionslist - Only companies in these parts of the world.One or more of:
northamerica(North America),europe,asia,middleeast(Middle East),africa,oceania,southamerica(South America). - Fewest employees
min_employeesnumber - Only companies with at least this many.At least 0.
- Most employees
max_employeesnumber - Only companies with at most this many.At least 0.
- Lowest revenue (millions)
min_revenuenumber - Only companies with at least this yearly revenue, in millions of US dollars.At least 0.
- Highest revenue (millions)
max_revenuenumber - Only companies with at most this yearly revenue, in millions of US dollars.At least 0.
- Sort by
sort_bytext - What to sort the companies by.One of:
companyRevenue(Revenue),employeeCount(Employees),businessType(Business type),location. - Order
sort_ordertext - Ascending or descending.One of:
asc(Ascending),desc(Descending). - Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 50. Defaults to 10.From 1 to 50.
Outputs
companieslist- The companies found, each with its companyId
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
total_countnumber- How many there are in all, across every page
Example output
{
"companies": [
{
"city": "Redmond",
"companyId": 726263,
"country": "US",
"name": "Example Software Inc.",
"state": "WA"
}
],
"page": 1,
"page_size": 10,
"total_count": 1
}Search contacts
Find people by name, job title, level or function, at given companies or a company's website, by country or industry. Gets one page of up to 50 with their contact ids, but not their emails or phones: get those with 'Get contact'. Needs the B2B API; uses no credits.
Inputs
- First name
first_nametext - The person's first name.
- Last name
last_nametext - The person's last name.
- Email
emailtext - The person's email address.
- Job titles
titleslist - Job titles to look for, one per row, such as Marketing Director.
- Company IDs
company_idslist - Only people at these companies: Demandbase company ids, one per row, from 'Search companies' or an earlier step.
- Company name
company_nametext - Only people at a company of this name.
- Company website
company_websitetext - Only people at the company with this web domain, such as demandbase.com.
- Company country
company_countrytext - Only people at companies in this country.One of:
68(Afghanistan),1(Ahvenanmaan Laani),120(Albania),109(Algeria),2(American Samoa),114(Andorra),121(Angola),3(Anguilla),4(Antarctica),5(Antigua and Barbuda), and 243 more. - Person's country
contact_countrytext - Only people who are in this country.One of:
68(Afghanistan),1(Ahvenanmaan Laani),120(Albania),109(Algeria),2(American Samoa),114(Andorra),121(Angola),3(Anguilla),4(Antarctica),5(Antigua and Barbuda), and 243 more. - Job levels
job_levelslist - Only people at these levels, such as Director or C Level.One or more of:
0(Board Member),1(C Level),2(Senior Executive),3(Vice President),4(Director),5(Manager),8(Lead & Senior),6(Others),9(Mid & Entry). - Job functions
job_functionslist - Only people in these functions, such as Marketing.One or more of:
1(Academics),2(Accounting),3(Administration),4(Business Development),5(Construction Engineering),6(Consulting),7(Customer Support),8(Human Resources),9(Information Technology),10(Investment Management), and 14 more. - Industries
industrieslist - Only companies in any of these industries.One or more of:
1(Aerospace and Defense),2(Agriculture and Forestry),3(Automotive),4(Banks),5(Chemicals),6(Civic, Non-Profit and Membership Groups),7(Computer Hardware),8(Computer Software),9(Construction and Building Materials),10(Consumer Product Manufacturing), and 20 more. - Fewest employees
min_employeesnumber - Only companies with at least this many.At least 0.
- Most employees
max_employeesnumber - Only companies with at most this many.At least 0.
- Only with an email
email_requiredtrue/false - Only people Demandbase has an email for.
- Only with a phone
phone_requiredtrue/false - Only people Demandbase has a phone number for.
- Lowest data quality
min_contact_quality_scoretext - Only people whose details Demandbase rates at least this well.One of:
A+(A+ (best)),A(A or better),B(B or better),C(C or better). - Sort by
sort_bytext - What to sort the people by.One of:
companyName(Company name),title(Job title),active(Still in the job). - Order
sort_ordertext - Ascending or descending.One of:
asc(Ascending),desc(Descending). - Page
pagenumber - Which page to get, from 1. Defaults to 1.At least 1.
- Page size
per_pagenumber - How many to get on a page, 1 to 50. Defaults to 10.From 1 to 50.
Outputs
contactslist- The people found, each with dbPersonDetails and employmentDetails
pagenumber- This page's number, from 1
page_sizenumber- How many a page holds
total_countnumber- How many there are in all, across every page
Example output
{
"contacts": [
{
"dbPersonDetails": {
"city": "Seattle",
"country": "United States",
"dbPersonId": 15568398,
"firstName": "Jamie",
"lastName": "Taylor"
},
"employmentDetails": {
"active": true,
"companyId": 726263,
"companyName": "Example Software Inc.",
"contactId": 17864319,
"contactQualityScore": "A",
"hasEmail": true,
"hasPhone": true,
"jobFunctions": [
{
"id": "14",
"name": "Marketing"
}
],
"jobLevels": [
{
"id": "3",
"name": "Vice President"
}
],
"titles": [
"Vice President, Marketing"
]
}
}
],
"page": 1,
"page_size": 10,
"total_count": 1
}Start export
Export your Demandbase accounts, people, opportunities or activities with the fields you pick, such as an account's journey stage, engagement minutes and scores, to a file. Demandbase builds it in a job: get the file's link with 'Get export job' or the 'Export finished' trigger. Needs the Data Export API.
Inputs
- Records
entity_typetextRequired - What to export.One of:
account(Accounts),person(People),opportunity(Opportunities),activity(Activities). - Fields
fieldslistRequired - The fields to put in the file, such as an account's journey stage, engagement minutes or scores. Pick what to export first, or give field names such as {Account}.name.
- Export name
job_nametext - A name for the export. Defaults to Lodol and the records.
- From
from_datedate - Only records from this day on, for activities and similar.
- To
to_datedate - Only records up to this day.
- Account list IDs
account_list_idslist - Only accounts in these lists, one list id per row, from 'Export account lists'.Only when Records is Accounts.
- Person list IDs
person_list_idslist - Only people in these lists, one list id per row.Only when Records is People.
- Most records
max_recordsnumber - The most records to export.At least 1.
- File format
file_formattext - JSON or CSV. Defaults to JSON.One of:
JSON,CSV.
Outputs
jobobject- The export job. Follow it with 'Get export job' until it is finished.
Example output
{
"job": {
"createdAt": "2026-11-02T16:43:57.378Z",
"entityType": "account",
"jobId": "dcb34525-2baa-4f54-8c11-9e6175ecbc74",
"jobName": "Lodol account export",
"jobStatus": "accepted"
}
}Update keyword set
Rename a keyword set, mark it competitive or not, or add and remove keywords and seed pages. Needs the Intent API.
Inputs
- Keyword set
keyword_set_idtextRequired - The keyword set. Pick one, or give its id from an earlier step.
- New name
nametext - A new name. Leave empty to keep it.
- Competitive
competitortext - Whether the set is about competitors.One of:
unchanged(Leave as is),competitor(Competitive),not_competitor(Not competitive). Default:unchanged. - Keywords to add
add_keywordslist - Keywords to add, one per row.
- Keywords to remove
remove_keywordslist - Keywords to remove, one per row.
- Seed pages to add
add_seed_urlslist - Web pages to add, one https address per row.
- Seed pages to remove
remove_seed_urlslist - Web pages to remove, one address per row.
Outputs
keyword_setobject- The keyword set as it is now
Example output
{
"keyword_set": {
"createdAt": "2026-08-20T09:14:22Z",
"id": 9427,
"isCompetitor": false,
"keywords": [
{
"createdAt": "2026-08-20T09:14:22Z",
"id": 551201,
"keyword": "zero trust",
"updatedAt": "2026-08-20T09:14:22Z"
}
],
"name": "Cloud Security Vendors",
"seedUrls": [
{
"createdAt": "2026-08-20T09:14:22Z",
"id": 8801,
"seedUrl": "https://example.com/security"
}
],
"updatedAt": "2026-08-20T09:20:41Z"
}
}Update subscription
Add or remove the companies or people a subscription watches, or change its name, frequency, fields, news categories or webhook. Demandbase makes the change in a job. Needs the B2B API.
Inputs
- Subscription
subscription_idtextRequired - The subscription. Pick one, or give its id from an earlier step.
- Watches
subscription_typetextRequired - What the subscription watches, as it was created.One of:
company(Company changes),companyNews(Company news),dbPerson(Person changes),companyFamilyTree(Company family tree changes). - Companies to add
add_company_idslist - Demandbase company ids to start watching, one per row.Only when Watches is Company changes, Company news or Company family tree changes.
- Companies to remove
remove_company_idslist - Demandbase company ids to stop watching, one per row.Only when Watches is Company changes, Company news or Company family tree changes.
- People to add
add_person_idslist - Demandbase person ids to start watching, one per row.Only when Watches is Person changes.
- People to remove
remove_person_idslist - Demandbase person ids to stop watching, one per row.Only when Watches is Person changes.
- New name
nametext - A new name. Leave empty to keep it.
- New description
descriptiontext - A new description. Leave empty to keep it.
- Check every
frequency_everynumber - How many of the unit to wait between checks, such as 7 for every 7 days. The shortest is 1 day for companies and people, 15 minutes for news and 1 week for family trees.At least 1.
- Unit
frequency_unittext - The unit of 'Check every'. Defaults to days.One of:
d(Days),w(Weeks),m(Months),h(Hours),M(Minutes). - Company fields to watch
company_fieldslist - Alert when any of these change. Leave empty to watch every field.Only when Watches is Company changes. One or more of:
all(Any field),name,activeStatus(Active status),companyStatus(Company status),companyType(Company type),businessStructure(Business structure),revenue,revenueRange(Revenue range),employees,employeeRange(Employee range), and 12 more. - Person fields to watch
person_fieldslist - Alert when any of these change, such as a new job. Leave empty to watch every field.Only when Watches is Person changes. One or more of:
all(Any field),newEmployment(New job),titles(Job titles),active(Still in the job),name,email,phone,executiveMobileNo(Mobile number),linkedInHandle(LinkedIn),twitterHandle(X (Twitter)), and 6 more. - News categories
news_categorieslist - Only alert on news in these categories. Leave empty for every category.Only when Watches is Company news. One or more of:
LEADERSHIP_CHANGES(Leadership Changes),NEW_OFFERINGS(New Offerings),ACQUISITIONS,PARTNERSHIPS,EXPANDING_OPERATIONS(Expanding Operations),COST_CUTTING(Cost Cutting),OUTPERFORMING,UNDERPERFORMING,COMPANY_PRESENTATION(Company Presentation),LITIGATION, and 8 more. - Webhook address
webhook_urltext - An https address of your own for Demandbase to post each alert to. It must answer Demandbase's check first. Leave empty to read alerts in Lodol instead.
- Signing secret
signing_secrettext - A secret Demandbase signs each webhook post with, up to 500 characters.
Outputs
jobobject- The job Demandbase runs the change in. Its subscriptionId is filled in once the job finishes; read it with 'Get subscription job'.
Example output
{
"job": {
"createdAt": "2026-11-02T09:00:42.620Z",
"invalidIds": [],
"jobId": "39ddf756-c04e-465c-b8c1-8d2c2be0abed",
"jobStatus": "accepted",
"jobType": "notificationSubscriptionUpdate",
"message": "",
"subscriptionId": "63914a27-a5ca-4fdf-80b0-ffc985f53c14",
"subscriptionType": "company",
"totalEntitiesProcessed": 2
}
}