# Bombora

> B2B intent data platform — query Bombora Company Surge® signals to identify companies actively researching topics relevant to your business, ranked by intent score.

Source: https://cotera.co/docs/reference/tools/individual-tools/bombora

---

**Authentication Type:** Bearer Token (OAuth 2.0)\
**Description:** B2B intent data platform — query Bombora Company Surge® signals to identify companies actively researching topics relevant to your business, ranked by intent score.

***

## Authentication

Bombora uses OAuth 2.0 bearer tokens. Obtain an access token from the [Bombora Developer Portal](https://developer.bombora.com) using your client credentials.

**Required Credentials:**

* `bearerToken` — your Bombora OAuth 2.0 access token

***

## Intent Data

Query Bombora's Company Surge® intent data to surface companies showing elevated research activity around specific topics.

### Intent Query

Submit an intent data query and retrieve the first page of results. Bombora returns company-level intent scores indicating which domains are actively researching your topics above their historical baseline.

**Operation Type:** Query (Read)

**Parameters:**

* **topics** `array of strings` (optional, default: `[]`): Bombora topic IDs to filter intent data by (max 50). Leave empty to retrieve intent across all topics.
* **attributes** `array of strings` (optional): Fields to include in each result record. Common values:
  * `domain` — the company's domain
  * `score` — intent score (0–100)
  * `scoreLabel` — label such as "Low", "Medium", "High"
  * `topicsCount` — number of topics showing elevated research
  * `topics` — full topic breakdown
  * `company.name` — company name
  * `company.industry` — industry classification
  * `company.size` — company size
  * `company.revenue` — estimated revenue
  * `company.hq.country` — headquarters country
  * `company.hq.state` — headquarters state
* **limit** `number` (optional, default: `100`): Maximum records to return (1–10,000)
* **filters** `array of objects` (optional, default: `[]`): Narrow results using field-level filters
  * **field** `string` (required): Field name to filter on (e.g. `"score"`, `"domain"`)
  * **operator** `string` (required): Comparison operator: `"eq"`, `"neq"`, `"gt"`, `"gte"`, `"lt"`, `"lte"`, `"in"`, `"nin"`
  * **value** `string` (required): Value to compare against

**Returns:**

* **records** `array of objects`: Intent records for matching companies
  * **domain** `string` (nullable): Company domain
  * **score** `number` (nullable): Intent score (0–100; higher = more active research)
  * **scoreLabel** `string` (nullable): Human-readable score label (e.g. `"High"`)
  * **topicsCount** `number` (nullable): Number of topics showing elevated activity
  * **companyName** `string` (nullable): Company name
  * **companyIndustry** `string` (nullable): Industry classification
  * **companyCountry** `string` (nullable): Headquarters country
  * **rawData** `object`: The full raw record as returned by the Bombora API
* **totalReturned** `number`: Number of records in this response
* **hasMorePages** `boolean`: Whether additional pages of results are available
* **nextPageToken** `string` (nullable): Token to retrieve the next page of results

**Example Usage:**

```json
{
  "topics": ["cloud-computing", "cybersecurity"],
  "attributes": [
    "domain",
    "score",
    "scoreLabel",
    "topicsCount",
    "company.name",
    "company.industry",
    "company.hq.country"
  ],
  "limit": 100,
  "filters": [{ "field": "score", "operator": "gte", "value": "60" }]
}
```

**Example Use Cases:**

* Surface high-intent accounts for SDR outreach based on research activity
* Prioritize pipeline by filtering leads showing intent on key topics
* Trigger alerts or workflows when target accounts show elevated intent signals
* Enrich company records with intent scores for ABM (Account-Based Marketing) campaigns

***

## Common Use Cases

**Sales Prioritization:**

* Identify accounts actively researching your solution category and route them to sales
* Filter for high-score (≥ 60) accounts to focus SDR time on the highest-intent leads
* Combine intent with CRM data to find accounts in your ICP with current buying signals

**Account-Based Marketing:**

* Trigger personalized ad campaigns for accounts showing intent on specific topics
* Create dynamic audience lists based on weekly intent score changes
* Identify greenfield accounts not yet in your CRM that are researching relevant topics

**Competitive Intelligence:**

* Monitor which accounts are researching competitor categories
* Track intent trends in your target market over time