What is Buyer Group Intelligence?

Buyer Group Intelligence is the practice of mapping and understanding the complete buying committee in enterprise sales. Instead of relying on a single champion, it identifies all stakeholders who impact the purchase decision.

How does Adrata help sales teams?

Adrata uses AI to automatically map buying committees, identify hidden stakeholders, understand each person's priorities, and provide actionable intelligence to close deals faster.

What is the sales tarpit problem?

The sales tarpit is when enterprise deals get stuck despite having a champion. Modern B2B buying involves 6-10+ stakeholders, each with veto power. Adrata helps teams navigate this complexity.

What is Buyer Group Intelligence?

Buyer Group Intelligence is the practice of mapping and understanding the complete buying committee in enterprise sales. Instead of relying on a single champion, it identifies all stakeholders (decision makers, influencers, blockers, and end users) who impact the purchase decision.

How does Adrata help sales teams?

Adrata uses AI to automatically map buying committees, identify hidden stakeholders, understand each person's priorities, and provide actionable intelligence to close deals faster. It helps sales teams escape the 'tarpit' where deals stall due to complex buying processes.

What is the sales tarpit problem?

The sales tarpit is when enterprise deals get stuck despite having a champion. Modern B2B buying involves 6-10+ stakeholders, each with veto power. Deals drag on for months as new stakeholders emerge and 'build vs buy' debates stall decisions. Adrata helps teams navigate this complexity.

Adrata

Back to Docs

API Reference

Complete REST API for the Adrata platform.

Access companies, people, buyer groups, opportunities, and intelligence data. JSON responses, cursor-based pagination, and webhook events.

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from your workspace Settings → API Keys.

Authorization header

Authorization: Bearer ak_live_xxxxxxxxxxxxxxxxxxxx

Live keys

Prefixed with ak_live_. Full access to production data.

Test keys

Prefixed with ak_test_. Sandbox environment, no real data affected.

Scoped permissions

Keys can be scoped to read-only, write, or admin. Limit blast radius.

Base URL

Production

https://api.adrata.com

All endpoints are versioned under /v1. We guarantee backward compatibility within a major version.

Rate Limits

Rate limits are applied per API key. Limits reset on a rolling 1-hour window.

Plan	Requests / hour	Burst
Free	100	10 req/sec
Pro	1,000	50 req/sec
Enterprise	10,000	200 req/sec

Rate limit headers are included in every response:

Response headers

X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 947

X-RateLimit-Reset: 1708372800

Pagination

List endpoints use cursor-based pagination. Pass limit and cursor as query parameters.

Paginated request

GET /v1/companies?limit=25&cursor=eyJpZCI6MTAwfQ

Response shape

{

"data": [...],

"next_cursor": "eyJpZCI6MTI1fQ",

"has_more": true,

"total": 2847

}

Error Handling

Errors return a consistent JSON structure with an HTTP status code, error type, and human-readable message.

Error response

{

"error": "not_found",

"message": "Company with id 'abc123' not found.",

"statusCode": 404

}

Status	Error	Meaning
400	bad_request	Invalid parameters or request body
401	unauthorized	Missing or invalid API key
403	forbidden	Key lacks required permission scope
404	not_found	Resource does not exist
429	rate_limited	Too many requests. Check X-RateLimit-Reset header
500	internal_error	Server error. Retry with exponential backoff

Code Examples

Search for companies using the API. These examples show the same request in curl, TypeScript, and Python.

curl

curl \

-H "Authorization: Bearer $API_KEY" \

"https://api.adrata.com/v1/companies?search=Acme&limit=10"

TypeScript

const res = await fetch(

'https://api.adrata.com/v1/companies?search=Acme',

{ headers: {

'Authorization': `Bearer ${API_KEY}`

} }

);

const data = await res.json();

Python

import requests

r = requests.get(

"https://api.adrata.com/v1/companies",

params={"search": "Acme"},

headers={"Authorization": f"Bearer {API_KEY}"},

)

data = r.json()

Endpoint Reference

All endpoints are available under https://api.adrata.com/v1. Click an endpoint group to see details.

Companies

Search, list, create, and update company records. Includes enrichment data, intelligence scores, and buyer group coverage.

GET/v1/companies

GET/v1/companies/:id

POST/v1/companies

PATCH/v1/companies/:id

People

Manage contacts and leads. Access enrichment data, engagement history, and stakeholder role classifications.

GET/v1/people

GET/v1/people/:id

POST/v1/people

PATCH/v1/people/:id

Buyer Groups

Map buying committees for target accounts. Get stakeholder roles, coverage gaps, and engagement signals.

GET/v1/buyer-groups

GET/v1/buyer-groups/:id

POST/v1/buyer-groups

POST/v1/buyer-groups/:id/members

Opportunities

Full pipeline access. Create, update, and track opportunities with deal health scores and stage progression.

GET/v1/opportunities

GET/v1/opportunities/:id

POST/v1/opportunities

PATCH/v1/opportunities/:id

Intelligence

AI-powered analysis endpoints. Generate deal summaries, risk assessments, next-step recommendations, and competitive intelligence.

POST/v1/intelligence/analyze

POST/v1/intelligence/summarize

GET/v1/intelligence/risks/:opportunityId

Search

Unified search across all entities. Full-text search with filters, facets, and relevance ranking.

GET/v1/search

POST/v1/search/advanced

Full Example: Create a Buyer Group

This example creates a buyer group for a target account and retrieves the mapped stakeholders.

curl

# 1. Create a buyer group for ServiceNow

curl -X POST https://api.adrata.com/v1/buyer-groups \

-H "Authorization: Bearer $API_KEY" \

-H "Content-Type: application/json" \

-d '{

"company_id": "comp_8xk2m9",

"opportunity_id": "opp_3jf82k",

"tier": "know"

# Response: 201 Created

{

"id": "bg_9xm3k7",

"company": "ServiceNow",

"members": [

{ "name": "Priya Kapoor", "title": "VP RevOps", "role": "champion" },

{ "name": "Marcus Chen", "title": "CRO", "role": "decision_maker" },

{ "name": "Rachel Torres", "title": "CFO", "role": "economic_buyer" },

{ "name": "David Kim", "title": "Dir. Engineering", "role": "evaluator" }

"coverage_score": 0.82,

"gaps": ["legal", "procurement"]

}

Ready to build?

Get your API key and start making requests in minutes.

Agent Quickstart MCP Server

Back to Docs

API Reference

Complete REST API for the Adrata platform.

Access companies, people, buyer groups, opportunities, and intelligence data. JSON responses, cursor-based pagination, and webhook events.

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from your workspace Settings → API Keys.

Authorization header

Authorization: Bearer ak_live_xxxxxxxxxxxxxxxxxxxx

Live keys

Prefixed with ak_live_. Full access to production data.

Test keys

Prefixed with ak_test_. Sandbox environment, no real data affected.

Scoped permissions

Keys can be scoped to read-only, write, or admin. Limit blast radius.

Base URL

Production

https://api.adrata.com

All endpoints are versioned under /v1. We guarantee backward compatibility within a major version.

Rate Limits

Rate limits are applied per API key. Limits reset on a rolling 1-hour window.

Plan	Requests / hour	Burst
Free	100	10 req/sec
Pro	1,000	50 req/sec
Enterprise	10,000	200 req/sec

Rate limit headers are included in every response:

Response headers

X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 947

X-RateLimit-Reset: 1708372800

Pagination

List endpoints use cursor-based pagination. Pass limit and cursor as query parameters.

Paginated request

GET /v1/companies?limit=25&cursor=eyJpZCI6MTAwfQ

Response shape

{

"data": [...],

"next_cursor": "eyJpZCI6MTI1fQ",

"has_more": true,

"total": 2847

}

Error Handling

Errors return a consistent JSON structure with an HTTP status code, error type, and human-readable message.

Error response

{

"error": "not_found",

"message": "Company with id 'abc123' not found.",

"statusCode": 404

}

Status	Error	Meaning
400	bad_request	Invalid parameters or request body
401	unauthorized	Missing or invalid API key
403	forbidden	Key lacks required permission scope
404	not_found	Resource does not exist
429	rate_limited	Too many requests. Check X-RateLimit-Reset header
500	internal_error	Server error. Retry with exponential backoff

Code Examples

Search for companies using the API. These examples show the same request in curl, TypeScript, and Python.

curl

curl \

-H "Authorization: Bearer $API_KEY" \

"https://api.adrata.com/v1/companies?search=Acme&limit=10"

TypeScript

const res = await fetch(

'https://api.adrata.com/v1/companies?search=Acme',

{ headers: {

'Authorization': `Bearer ${API_KEY}`

} }

);

const data = await res.json();

Python

import requests

r = requests.get(

"https://api.adrata.com/v1/companies",

params={"search": "Acme"},

headers={"Authorization": f"Bearer {API_KEY}"},

)

data = r.json()

Endpoint Reference

All endpoints are available under https://api.adrata.com/v1. Click an endpoint group to see details.

Companies

Search, list, create, and update company records. Includes enrichment data, intelligence scores, and buyer group coverage.

GET/v1/companies

GET/v1/companies/:id

POST/v1/companies

PATCH/v1/companies/:id

People

Manage contacts and leads. Access enrichment data, engagement history, and stakeholder role classifications.

GET/v1/people

GET/v1/people/:id

POST/v1/people

PATCH/v1/people/:id

Buyer Groups

Map buying committees for target accounts. Get stakeholder roles, coverage gaps, and engagement signals.

GET/v1/buyer-groups

GET/v1/buyer-groups/:id

POST/v1/buyer-groups

POST/v1/buyer-groups/:id/members

Opportunities

Full pipeline access. Create, update, and track opportunities with deal health scores and stage progression.

GET/v1/opportunities

GET/v1/opportunities/:id

POST/v1/opportunities

PATCH/v1/opportunities/:id

Intelligence

AI-powered analysis endpoints. Generate deal summaries, risk assessments, next-step recommendations, and competitive intelligence.

POST/v1/intelligence/analyze

POST/v1/intelligence/summarize

GET/v1/intelligence/risks/:opportunityId

Search

Unified search across all entities. Full-text search with filters, facets, and relevance ranking.

GET/v1/search

POST/v1/search/advanced

Full Example: Create a Buyer Group

This example creates a buyer group for a target account and retrieves the mapped stakeholders.

curl

# 1. Create a buyer group for ServiceNow

curl -X POST https://api.adrata.com/v1/buyer-groups \

-H "Authorization: Bearer $API_KEY" \

-H "Content-Type: application/json" \

-d '{

"company_id": "comp_8xk2m9",

"opportunity_id": "opp_3jf82k",

"tier": "know"

# Response: 201 Created

{

"id": "bg_9xm3k7",

"company": "ServiceNow",

"members": [

{ "name": "Priya Kapoor", "title": "VP RevOps", "role": "champion" },

{ "name": "Marcus Chen", "title": "CRO", "role": "decision_maker" },

{ "name": "Rachel Torres", "title": "CFO", "role": "economic_buyer" },

{ "name": "David Kim", "title": "Dir. Engineering", "role": "evaluator" }

"coverage_score": 0.82,

"gaps": ["legal", "procurement"]

}

Ready to build?

Get your API key and start making requests in minutes.

Agent Quickstart MCP Server