Bombora intent (async)

Businesses Bombora Intent Job

curl --request POST \
  --url https://api.explorium.ai/v2/businesses/bombora_intent/job \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "list_id": "<string>",
  "notifications": {
    "email": {
      "enabled": true,
      "on": []
    }
  },
  "parameters": {
    "topics": [
      "<string>"
    ],
    "min_score": 123
  }
}
'

import requests

url = "https://api.explorium.ai/v2/businesses/bombora_intent/job"

payload = {
    "list_id": "<string>",
    "notifications": { "email": {
            "enabled": True,
            "on": []
        } },
    "parameters": {
        "topics": ["<string>"],
        "min_score": 123
    }
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    list_id: '<string>',
    notifications: {email: {enabled: true, on: []}},
    parameters: {topics: ['<string>'], min_score: 123}
  })
};

fetch('https://api.explorium.ai/v2/businesses/bombora_intent/job', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.explorium.ai/v2/businesses/bombora_intent/job",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'list_id' => '<string>',
    'notifications' => [
        'email' => [
                'enabled' => true,
                'on' => [
                                
                ]
        ]
    ],
    'parameters' => [
        'topics' => [
                '<string>'
        ],
        'min_score' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.explorium.ai/v2/businesses/bombora_intent/job"

	payload := strings.NewReader("{\n  \"list_id\": \"<string>\",\n  \"notifications\": {\n    \"email\": {\n      \"enabled\": true,\n      \"on\": []\n    }\n  },\n  \"parameters\": {\n    \"topics\": [\n      \"<string>\"\n    ],\n    \"min_score\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/businesses/bombora_intent/job")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"list_id\": \"<string>\",\n  \"notifications\": {\n    \"email\": {\n      \"enabled\": true,\n      \"on\": []\n    }\n  },\n  \"parameters\": {\n    \"topics\": [\n      \"<string>\"\n    ],\n    \"min_score\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v2/businesses/bombora_intent/job")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"list_id\": \"<string>\",\n  \"notifications\": {\n    \"email\": {\n      \"enabled\": true,\n      \"on\": []\n    }\n  },\n  \"parameters\": {\n    \"topics\": [\n      \"<string>\"\n    ],\n    \"min_score\": 123\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "job_id": "<string>",
  "status": "<string>",
  "status_url": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

businesses

bombora_intent

job

Businesses Bombora Intent Job

curl --request POST \
  --url https://api.explorium.ai/v2/businesses/bombora_intent/job \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "list_id": "<string>",
  "notifications": {
    "email": {
      "enabled": true,
      "on": []
    }
  },
  "parameters": {
    "topics": [
      "<string>"
    ],
    "min_score": 123
  }
}
'

import requests

url = "https://api.explorium.ai/v2/businesses/bombora_intent/job"

payload = {
    "list_id": "<string>",
    "notifications": { "email": {
            "enabled": True,
            "on": []
        } },
    "parameters": {
        "topics": ["<string>"],
        "min_score": 123
    }
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    list_id: '<string>',
    notifications: {email: {enabled: true, on: []}},
    parameters: {topics: ['<string>'], min_score: 123}
  })
};

fetch('https://api.explorium.ai/v2/businesses/bombora_intent/job', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.explorium.ai/v2/businesses/bombora_intent/job",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'list_id' => '<string>',
    'notifications' => [
        'email' => [
                'enabled' => true,
                'on' => [
                                
                ]
        ]
    ],
    'parameters' => [
        'topics' => [
                '<string>'
        ],
        'min_score' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.explorium.ai/v2/businesses/bombora_intent/job"

	payload := strings.NewReader("{\n  \"list_id\": \"<string>\",\n  \"notifications\": {\n    \"email\": {\n      \"enabled\": true,\n      \"on\": []\n    }\n  },\n  \"parameters\": {\n    \"topics\": [\n      \"<string>\"\n    ],\n    \"min_score\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/businesses/bombora_intent/job")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"list_id\": \"<string>\",\n  \"notifications\": {\n    \"email\": {\n      \"enabled\": true,\n      \"on\": []\n    }\n  },\n  \"parameters\": {\n    \"topics\": [\n      \"<string>\"\n    ],\n    \"min_score\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v2/businesses/bombora_intent/job")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"list_id\": \"<string>\",\n  \"notifications\": {\n    \"email\": {\n      \"enabled\": true,\n      \"on\": []\n    }\n  },\n  \"parameters\": {\n    \"topics\": [\n      \"<string>\"\n    ],\n    \"min_score\": 123\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "job_id": "<string>",
  "status": "<string>",
  "status_url": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Description

The Business Intent Topics (Bombora) — Asynchronous enrichment enables you to retrieve intent topic insights for multiple businesses in a single request.
It reveals which topics each company is actively researching online, offering comprehensive visibility into collective business interests and buying intent across a portfolio of accounts. Powered by Bombora’s weekly intent dataset, the enrichment analyzes topic-level content consumption patterns to detect surging interest signals and engagement intensity at the company level. For each provided company (business_id), the enrichment returns a ranked list of intent topics with a composite score above 60, grouped by category and timestamped by week.
The results highlight which topics each business is researching most intensely and classify them by intent level (In-Depth, Active, Early). This enrichment is particularly useful for:

Account prioritization: Identify which companies across your target list are currently researching relevant topics.
Intent-driven segmentation: Group accounts by research activity and level of engagement.
ABM automation: Scale intent-based personalization to entire account lists.
Pipeline acceleration: Detect surging interest signals across multiple prospects simultaneously.

Refresh cadence: Weekly Raw intent data powered by:

Asynchronous variant. This submits a job through the async job infrastructure — poll job status for progress and results. Input comes from an uploaded dataset (list_id); limits are 10,000 rows and a 24-hour run time.For the full output signal reference, see the synchronous endpoint.

How It Works

Input

Provide a list of business_id values obtained from the Match Businesses API.Optional parameters:

topic_parameters — semicolon-separated list of “category: topic” filters (e.g., technology: ios;other: vendor profiling).
- To build this list, use the Autocomplete endpoint with business_intent_topics — and preferably semantic_search=true — to retrieve a broader, smarter set of intent topics. This ensures your topic list is accurate, relevant, and aligned with Bombora’s taxonomy.
min_score — optional integer > 60. If omitted, the default threshold is 60.

💡 Recommendation:
To achieve a meaningful and accurate measurement of intent, it is strongly recommended to include at least 12 topics that reflect the company’s genuine areas of interest.
Providing too few topics — or omitting the list entirely — will return all available topics for the company, which may include a wide variety of unrelated subjects and lead to misleading or noisy intent insights.

Processing

The enrichment process queries Bombora’s weekly dataset to identify surging topics for each company in the provided list.
Only topics with composite_score >= threshold are returned, where:

threshold = min_score (if provided and >60)
otherwise threshold = 60 (default)

Output

Returns, for each input business_id, the company’s top intent topics, including the composite score, engagement level, and weekly timestamp.

Example — Request with min_score & Response

curl -X 'POST' \
  'https://api.explorium.ai/v2/businesses/bombora_intent/job' \
  -H 'accept: application/json' \
  -H 'api_key: "your api_key" \
  -H 'Content-Type: application/json' \
  -d '{
  "request_context": {},
  "parameters": {
    "topics": [
      "training & development: corporate universities;training & development: career management;training & development: group coaching;training & development: classroom management;training & development: experiential learning;training & development: gmat test preparation;training & development: seminars and educational programs;training & development: sat preparation;training & development: team building;training & development: gmat test preparation;training & development: essential skills;training & development: gre test preparation"
    ],
    "min_score": 76
  },
  "business_id": ["8adce3ca1cef0c986b22310e369a0793"]
}

{
  "response_context": {
    "correlation_id": "34e96a94f55d40a18994f55b2f36ecb8",
    "request_status": "success",
    "time_taken_in_seconds": 43.515
  },
  "data": {
    "business_id": "8adce3ca1cef0c986b22310e369a0793",
    "company_name": "apple",
    "company_website": "apple.com",
    "date_stamp": "20251102",
    "intent_topics": "[{\"topic\":\"training & development: gmat test preparation\",\"composite_score\":76},{\"topic\":\"training & development: seminars and educational programs\",\"composite_score\":82},{\"topic\":\"training & development: classroom management\",\"composite_score\":77},{\"topic\":\"training & development: experiential learning\",\"composite_score\":76}]",
    "level_of_intent": "In Depth Research",
    "topic_count": "4 / 12"
  }
}

Best Practices

Always provide valid business_id inputs retrieved from the Match Businesses API.
Specify topic_parameters to focus enrichment results on relevant industries or technologies.
Use min_score only if you wish to raise the threshold above 60 — values ≤60 are not valid.
Check for null values — if Bombora has no data for a given domain, all topic-related fields will return null.
Combine intent data with firmographic and technographic enrichments for full go-to-market insights.
Use the Autocomplete endpoint with business_intent_topics — and preferably semantic_search=true — to build accurate and relevant topic_parameters before running enrichment.

Intent Topics Output Signals

Signal	API Name	Description	Data Type
level_of_intent	Level of Intent	Indicates how actively a company engaged with selected topics during the past week. Calculation: Number of topics with a composite score above 25% divided by the total number of input topics. Ranges: • >25% → In-Depth Research • 5–25% → Active Research • <5% → Early Research Recommendation: To ensure a meaningful and accurate reflection of intent, it is recommended to input at least 12 topicsthat are relevant to the areas of interest. Returns `null` when no input topics are available.	CATEGORY
topic_count	Topic Count	Shows the number of topics with a composite score above 60, relative to all topics evaluated (e.g., 5/5). When no input topics are provided, all topics are returned.	TEXT
intent_topics	Intent Topics	Contains an array of objects summarizing the company’s active interest in specific Bombora topics over a given week. Each object includes the topic name, category, composite score, and date.	TEXT
company_website	Company Website	The company’s primary website or domain URL.	URL
company_name	Company Name	The official or recognized name of the company.	TEXT
date_stamp	date	The date of the most recent Bombora data file (weekly), in format YYYYMMDD	TEXT

📌 _For additional enrichment options, explore related API endpoints below.

Authorizations

api_key

string

header

required

Body

application/json

list_id

string

required

Entity ID list identifier returned by the upload endpoint

notifications

V2AsyncJobNotifications · object

Show child attributes

parameters

BomboraIntentEnrichmentParams · object

Show child attributes

Response

Successful Response

job_id

string

required

status

string

required

status_url

string

required

Getting started

Businesses

Business enrichments

Prospects

Prospect enrichments

Research (GenAI)

Async jobs

Autocomplete

Credits

Events & Webhooks

Description

Input

Processing

Output

Authorizations

Body

Response

​Description

​Input

​Processing

​Output

Authorizations

Body

Response

Description

Input

Processing

Output