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

ActionWhat it does
Create keyword setCreate a keyword set to measure intent against, with its keywords and any web pages Demandbase should draw more keywords from.
Create subscriptionStart watching companies, their news, their family trees or people for changes.
Delete subscriptionDelete a subscription, which stops its checks and alerts for good.
Export account listsExport every account list with its id, or the accounts in the lists you give.
Get companyGet 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 intentFind 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 newsGet recent news about a company, such as leadership changes, funding or acquisitions, from all categories or the ones you pick.
Get contactGet a person's job, email addresses, phone numbers, job level and function, and social profiles, by their contact id.
Get credit usageSee how many B2B API credits your Demandbase account has, has used and has left.
Get export jobCheck an export: accepted, processing, finished or failed, and once finished the link to download its file, which works for 24 hours.
Get subscriptionGet a subscription's settings: what it watches, how often it checks, when it next checks and its webhook.
Get subscription alertGet 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 jobCheck 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 jobsList the exports started for your Demandbase account, newest first, with their status.
List keyword setsList the keyword sets intent is measured against, with their ids.
List keywords in a setList one page of a keyword set's keywords.
List subscription alertsList the alerts a subscription has made, newest first: one for each check that found changes.
List subscriptionsList your Demandbase subscriptions, which watch companies, people or company news for changes.
Match companyFind 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 companiesFind companies in Demandbase's database by name, website, country, industry, size, revenue and more.
Search contactsFind people by name, job title, level or function, at given companies or a company's website, by country or industry.
Start exportExport 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 setRename a keyword set, mark it competitive or not, or add and remove keywords and seed pages.
Update subscriptionAdd 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

NamenametextRequired
The keyword set's name, which must be new.
Keywordskeywordslist
The keywords, one per row, such as zero trust.
Seed pagesseed_urlslist
Web pages, one https address per row, that Demandbase reads to suggest up to 100 more keywords.
Competitiveis_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

NamenametextRequired
A name to know the subscription by.
Watch forsubscription_typetextRequired
What the subscription watches.One of: company (Company changes), companyNews (Company news), dbPerson (Person changes), companyFamilyTree (Company family tree changes).
Company IDscompany_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 IDsperson_idslist
The people to watch, one Demandbase person id (dbPersonId) per row, from 'Search contacts'.Only when Watch for is Person changes.
Check everyfrequency_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.
Unitfrequency_unittext
The unit of 'Check every'. Defaults to days.One of: d (Days), w (Weeks), m (Months), h (Hours), M (Minutes).
Start datestart_datedate
When to start. The first check is one frequency after it.
Company fields to watchcompany_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 watchperson_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 categoriesnews_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.
Descriptiondescriptiontext
What the subscription is for.
Webhook addresswebhook_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 secretsigning_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

Subscriptionsubscription_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 IDsaccount_list_idslist
Lists whose accounts to export, one id per row. Leave empty to export every list instead.
Export namejob_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 IDcompany_idtextRequired
The Demandbase company id, digits such as 726263, from 'Search companies', 'Match company' or an earlier step.
Also getincludelist
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

Fromstart_datedateRequired
The first day to look at.
Toend_datedateRequired
The last day to look at, at most 12 months after 'From'.
Keyword setskeyword_set_idslist
Up to 10 keyword sets to look up intent for.
Keywordskeywordslist
Up to 50 keywords, one per row, such as zero trust.
Company IDscompany_idslist
Up to 10 Demandbase company ids, one per row, to look up intent for.
Intent strengthintent_strengthtext
Only signals of this strength. Leave empty for every strength.One of: HIGH, MED (Medium), LOW.
Fewest people researchingmin_people_researchingnumber
Only signals with at least this many people researching.At least 0.
Most people researchingmax_people_researchingnumber
Only signals with at most this many people researching.At least 0.
Sort bysort_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).
Ordersort_ordertext
Descending unless you choose.One of: DESC (Descending (default)), ASC (Ascending).
Most signalspage_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 IDcompany_idtextRequired
The Demandbase company id, digits such as 726263, from 'Search companies', 'Match company' or an earlier step.
Categoriescategorieslist
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.
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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 IDcontact_idtextRequired
The Demandbase contact id, from 'Search contacts' or 'Match company'.
Include other jobsinclude_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 IDjob_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

Subscriptionsubscription_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

Subscriptionsubscription_idtextRequired
The subscription. Pick one, or give its id from an earlier step.
Alert IDalert_idtextRequired
The alert's id, from 'List subscription alerts' or the alert trigger.
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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 IDjob_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

Recordsentity_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).
Statusjob_statustext
Only exports with this status.One of: All (Any status (default)), accepted, processing, finished, failed.
Ordersorttext
Newest or oldest first.One of: descending (Newest first (default)), ascending (Oldest first).
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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 containsname_containstext
Only keyword sets whose name contains this.
Sort bysort_bytext
What to sort them by.One of: createdAt (Created (default)), updatedAt (Last changed), name.
Ordersort_ordertext
Descending unless you choose.One of: DESC (Descending (default)), ASC (Ascending).
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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 setkeyword_set_idtextRequired
The keyword set. Pick one, or give its id from an earlier step.
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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

Subscriptionsubscription_idtextRequired
The subscription. Pick one, or give its id from an earlier step.
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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

Kindssubscription_typeslist
Only subscriptions of these kinds.One or more of: company (Company changes), companyNews (Company news), dbPerson (Person changes), companyFamilyTree (Company family tree changes).
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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 namecompany_nametext
The company's name, such as Acme Inc.
Websitewebsitetext
The company's website or domain, such as acme.com.
Work emailemailtext
A person's work email. It finds their company, and them too.
LinkedIn handlelinkedin_handletext
A person's LinkedIn handle, the part after linkedin.com/in/.
Stock tickertickertext
The company's stock ticker.
Phonephonetext
The company's phone number.
Streetstreettext
The company's street address.
Citycitytext
The company's city.
State or regionstatetext
The company's state or region, such as WA.
Postal codezip_codetext
The company's postal code.
Countrycountrytext
The company's country, by name, such as United States.
First namefirst_nametext
To match a person too: their first name.
Last namelast_nametext
To match a person too: their last name.
Job titletitletext
To match a person too: their job title.
Most matchesmax_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 namenametext
The company's name, or part of it.
Websitewebsitetext
The company's web domain, such as demandbase.com.
Stock tickertickertext
The company's stock ticker, such as MSFT.
Countrycountrytext
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 regionstatetext
A state or region code, such as CA.
Citiescitiestext
One or more cities, separated by commas, such as San Francisco, New York.
Industriesindustrieslist
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 typesbusiness_typeslist
Only these kinds of organization.One or more of: public, private, school, government, organization.
Company statuscompany_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 rankingfortune_rankingtext
Only Fortune 500 or Fortune 1000 companies.One of: fortune500 (Fortune 500), fortune1000 (Fortune 1000).
Business structurebusiness_structuretext
Only global parents, subsidiaries, branches and so on.One of: globalParent (Global parent), subsidiary, branch, independent, group, uncategorized.
Regionsregionslist
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 employeesmin_employeesnumber
Only companies with at least this many.At least 0.
Most employeesmax_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 bysort_bytext
What to sort the companies by.One of: companyRevenue (Revenue), employeeCount (Employees), businessType (Business type), location.
Ordersort_ordertext
Ascending or descending.One of: asc (Ascending), desc (Descending).
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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 namefirst_nametext
The person's first name.
Last namelast_nametext
The person's last name.
Emailemailtext
The person's email address.
Job titlestitleslist
Job titles to look for, one per row, such as Marketing Director.
Company IDscompany_idslist
Only people at these companies: Demandbase company ids, one per row, from 'Search companies' or an earlier step.
Company namecompany_nametext
Only people at a company of this name.
Company websitecompany_websitetext
Only people at the company with this web domain, such as demandbase.com.
Company countrycompany_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 countrycontact_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 levelsjob_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 functionsjob_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.
Industriesindustrieslist
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 employeesmin_employeesnumber
Only companies with at least this many.At least 0.
Most employeesmax_employeesnumber
Only companies with at most this many.At least 0.
Only with an emailemail_requiredtrue/false
Only people Demandbase has an email for.
Only with a phonephone_requiredtrue/false
Only people Demandbase has a phone number for.
Lowest data qualitymin_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 bysort_bytext
What to sort the people by.One of: companyName (Company name), title (Job title), active (Still in the job).
Ordersort_ordertext
Ascending or descending.One of: asc (Ascending), desc (Descending).
Pagepagenumber
Which page to get, from 1. Defaults to 1.At least 1.
Page sizeper_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

Recordsentity_typetextRequired
What to export.One of: account (Accounts), person (People), opportunity (Opportunities), activity (Activities).
FieldsfieldslistRequired
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 namejob_nametext
A name for the export. Defaults to Lodol and the records.
Fromfrom_datedate
Only records from this day on, for activities and similar.
Toto_datedate
Only records up to this day.
Account list IDsaccount_list_idslist
Only accounts in these lists, one list id per row, from 'Export account lists'.Only when Records is Accounts.
Person list IDsperson_list_idslist
Only people in these lists, one list id per row.Only when Records is People.
Most recordsmax_recordsnumber
The most records to export.At least 1.
File formatfile_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 setkeyword_set_idtextRequired
The keyword set. Pick one, or give its id from an earlier step.
New namenametext
A new name. Leave empty to keep it.
Competitivecompetitortext
Whether the set is about competitors.One of: unchanged (Leave as is), competitor (Competitive), not_competitor (Not competitive). Default: unchanged.
Keywords to addadd_keywordslist
Keywords to add, one per row.
Keywords to removeremove_keywordslist
Keywords to remove, one per row.
Seed pages to addadd_seed_urlslist
Web pages to add, one https address per row.
Seed pages to removeremove_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

Subscriptionsubscription_idtextRequired
The subscription. Pick one, or give its id from an earlier step.
Watchessubscription_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 addadd_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 removeremove_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 addadd_person_idslist
Demandbase person ids to start watching, one per row.Only when Watches is Person changes.
People to removeremove_person_idslist
Demandbase person ids to stop watching, one per row.Only when Watches is Person changes.
New namenametext
A new name. Leave empty to keep it.
New descriptiondescriptiontext
A new description. Leave empty to keep it.
Check everyfrequency_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.
Unitfrequency_unittext
The unit of 'Check every'. Defaults to days.One of: d (Days), w (Weeks), m (Months), h (Hours), M (Minutes).
Company fields to watchcompany_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 watchperson_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 categoriesnews_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 addresswebhook_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 secretsigning_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
  }
}

On this page