Getting Started

Welcome to the Demandbase Data Export API!

This guide will help you get started with using the API to export data from the Demandbase platform. You will learn how to authenticate, create export jobs, check job statuses, and retrieve available fields.

New Demandbase now offers Buying Group data through its Export API, giving RevOps and GTM teams programmatic access to account-level and person-level buying committee insights. This enhancement enables personalized campaign targeting, ABX orchestration, and CRM enrichment by exposing Buying Group completeness, engagement, and persona coverage directly into customer workflows.

Base URL

All API requests use the following unversioned server root. Each endpoint path includes its API version, such as /v1/fields.

URL

https://uapi.demandbase.com/data/export

Export job workflow

Export jobs are asynchronous. Every export follows the same three-step workflow:

1. Submit an export job

Send a request to the appropriate create-job endpoint. Most exports use POST /v1/job. A successful submission returns HTTP 202 with jobStatus set to accepted and a jobId that identifies the job. Save the jobId for the next step.

{
  "jobName": "AccountExportJob",
  "jobStatus": "accepted",
  "entityType": "account",
  "jobId": "dcb34525-2baa-4f54-8c11-9e6175ecbc74",
  "createdAt": "2024-03-24T16:43:57.378Z"
}

2. Poll the job status

Pass the returned jobId to GET /v1/job/{jobId}. Continue polling while jobStatus is accepted or processing. Stop when the status becomes finished or failed; both are terminal states.

curl --request GET \
  --url "https://uapi.demandbase.com/data/export/v1/job/${JOB_ID}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}"

3. Download the results

When jobStatus is finished, use the URL returned in resultsUrl to download the generated file. Campaign and creative exports can return multiple files in the resultsUrls array; download each URL separately. If the job finishes without a result URL, inspect the response message. A failed job does not produce a result file.

curl --location "${RESULTS_URL}" --output export.csv

Export API Trial

Interested in evaluating how the Demandbase Data Export API can support your data and integration workflows?

The Export API trial gives you an opportunity to explore the API, test requests, review response formats, and validate how Demandbase data can work within your systems.

Trial accounts can export up to 100 MB of data within a rolling 24-hour period. This allowance applies across all exports made during that period, rather than to each export individually. You can manage your usage by narrowing your filters or selecting fewer fields.

To participate in the Export API trial, contact your Demandbase Account Team. They can help determine whether the trial is right for your use case, enable access, and provide guidance to help you get started.

Postman Collection

Access a ready-to-use Postman collection for the Demandbase Data Export API to quickly test endpoints, explore request/response structures, and accelerate your integration workflow. You can find the full collection, setup instructions, and examples in the GitHub repo here .