Getting Started

Overview

The BIGDBM API suite lets you query behavioral intent signals, resolve identifiers, and enrich profiles, all over HTTPS using JSON payloads. Every response includes structured data you can pipe directly into your CRM, CDP, or data warehouse.

• Query consumer intent by keyword, date range, and volume
• Enrich emails, phones, addresses, MAIDs, and IPs in real time
• Receive hashed email (HEM) lists for audience activation
• All endpoints return standard JSON with consistent error shapes

Base URL

https://aws-behavioral-intent-api.bigdbm.com

All API requests must be made over HTTPS. HTTP requests will be rejected. API keys are issued per account and scoped to the products you have licensed.

Authentication

All BIGDBM API endpoints require a Bearer token passed in the Authorization header.

Header format:

Authorization: Bearer YOUR_TOKEN

Tokens are issued by your BIGDBM account representative. Each token is scoped to specific API products and rate limits. Do not share tokens or commit them to version control, use environment variables or a secrets manager.

• Tokens do not expire on a fixed schedule, but can be rotated on request
• Each token is tied to your organization and audit-logged
• A missing or invalid token returns 401 Unauthorized

Sync APIs

B2B Sync APIs

Enrich business records in real time using a wide range of B2B identifiers. Whether you're starting from a company name, an IP address, a LinkedIn profile, or a hashed email, these APIs instantly append firmographic, contact, and intent data to your existing records — accelerating sales, marketing, and operational workflows.

• Account-Based Marketing — match inbound signals to company records and trigger targeted campaigns
• Lead Enrichment — append missing firmographic and contact data to incomplete CRM records
• Real-time Scoring — enrich leads the moment they enter your pipeline for immediate sales prioritization
• Identity Resolution — match across identifiers (IP, email, LinkedIn, phone) to a single company profile

Available Endpoints

POST B2B Address - Resolve a physical business address to company identity, contacts, and firmographic data. Ideal for direct mail lists, field sales territory enrichment, and verifying inbound form data against known business locations.

POST B2B Email - Submit a business email address to retrieve the associated professional profile — including company, job title, seniority, and direct contact data.

POST B2B Maid - Match a Mobile Advertising ID (MAID) to a B2B identity. Bridge the gap between consumer mobile data and professional profiles.

POST B2B Phone - Resolve a business phone number to company name, industry, job function, and contact data.

POST B2B Company - Submit a company name, domain, or EIN to retrieve full firmographic data — including industry, revenue range, employee count, headquarters location, and decision-maker contacts.

POST B2B IP - Resolve a visiting IP address to a company identity — including company name, industry, size, and location.

POST B2B LinkedIn - Match a LinkedIn profile URL or Sales Navigator ID to enriched B2B contact and company data.

Sync APIs

Consumer Sync APIs

Enhance existing consumer records with additional attributes in real time. All consumer sync endpoints use a configurable Output ID (10008), fully customizable to your requirements before production deployment.

Available Endpoints

POST PII - The most comprehensive consumer resolution method. Submit a combination of name and address to receive a fully enriched consumer profile including demographics, financial indicators, contact data, and household attributes.

POST Email - Submit a raw consumer email address to append household demographics, contact information, income, lifestyle, and behavioral attributes.

POST Phone - Resolve a consumer phone number — mobile or landline — to household demographics, name, address, and lifestyle attributes.

Intent APIs

Intent by Item (IAB, Keyword, Domain)

The Intent API 2.4 enables you to discover individuals actively researching specific products, brands, or services. By surfacing people who are already showing buying intent, you can prioritize your highest-value prospects and reach them when they're most likely to convert.

POST /intent/createList

Creates an intent-based audience list and returns matching hashed email addresses (HEMs) for activation or enrichment.

Request Example

curl --location 'https://aws-behavioral-intent-api.bigdbm.com/intent/createList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data '{
    "StartDate": "2025-12-03",
    "EndDate": "2025-12-03",
    "Keywords": "audi",
    "NumberOfHems": 1000
}'

Parameters

Sample Response

{
  "status": "success",
  "listId": "lst_7f3a9b2c4d1e",
  "count": 1000,
  "hems": [
    {
      "hem": "a3f4e8b7c2d1901ef56a3b2c4d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5",
      "signal_date": "2025-12-03",
      "confidence": 0.94,
      "signal_count": 7
    }
  ],
  "metadata": {
    "processing_ms": 143,
    "keyword_match_pool": 48291,
    "api_version": "2.4"
  }
}

Response Codes