Overview
Getting Started
This API gives you access to Demandbase's data about companies, contacts, and people. You can use it to:
- Look up company details such as name, industry, revenue, number of employees, social media links, and more
- Retrieve or search for contact details (individuals, employees) associated with a company
- Fetch family-tree information, competitor data, or installed technologies for a company
- Access company news articles or logos
- Drill into granular details about a specific contact or person
By connecting to these endpoints, your applications can incorporate high-quality firmographic and demographic data—enabling targeted marketing, lead enrichment, or research workflows.
All endpoints are hosted under the Production base URL:
https://uapi.demandbase.com/data/b2b/v1/
Handling Errors
Each endpoint describes possible 400 (Bad Request), 401 (Unauthorized), 403 (Forbidden), 404 (Not Found), etc. responses in the OpenAPI specification.
{
"errorCode": "400-103",
"errorMessage": "companyId must be an integer.",
"diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4"
}Summary
This guide introduces the basic workflow of the Demandbase B2B API. With the included example, you can start making authenticated requests for company or contact data, searching and filtering the results to match your use case, and handling error scenarios gracefully.
For additional details, including the comprehensive list of query parameters, schemas, and error codes, refer to the full endpoint documentation for each endpoint.
If you have further questions, please reach out to your Demandbase representative or consult Demandbase Partner Support .
Happy coding!
Updated 3 days ago