B2B Data Index • API Reference

Cold Email
Intelligence API

Free, open REST API for B2B cold email benchmarks, compliance rules, and market intelligence across 74 countries and 14 industries. No authentication. No SDK. 1,000 free calls per month.

74Countries
3K+Benchmark Rows
44Compliance Rules
FreeNo Auth Required

The B2B Data Index API gives you structured access to the same intelligence that powers b2bdataindex.com — decision-maker benchmarks, email law compliance requirements, and market-specific outreach strategy data. Use it to build tools, power AI agents, or embed live benchmark cards on your site.

Getting Started

Base URL & Quick Start

All requests go to a single base URL. No version prefix required in path — the current version is v1.

curl — three calls to test the API
# Get all cold email benchmarks (3,000+ rows)
curl https://api.b2bdataindex.com/v1/benchmarks

# Get Germany market intelligence
curl https://api.b2bdataindex.com/v1/intelligence/germany

# Check your usage this month
curl https://api.b2bdataindex.com/v1/usage
javascript — fetch benchmarks and filter
const res  = await fetch('https://api.b2bdataindex.com/v1/benchmarks');
const data = await res.json();

// Filter by country
const de = data.filter(b => b.market === 'germany');

// Filter by country + industry
const deTech = data.filter(b =>
  b.market === 'germany' && b.industry === 'technology-software'
);
python
import requests

data = requests.get('https://api.b2bdataindex.com/v1/benchmarks').json()

# Filter for Germany + Technology
results = [
    b for b in data
    if b['market'] == 'germany' and b['industry'] == 'technology-software'
]
Access

Rate Limits

Free tier: 1,000 calls per month per IP address — no API key needed. Limits reset on the 1st of each calendar month. Every response includes rate limit headers so you can track usage.

Free Tier
1,000
calls/month · no key needed · available now
Pro Tier
50K
calls/month · API key · coming soon
Enterprise
∞
unlimited · SLA · contact us

Rate Limit Response Headers

X-RateLimit-Limit
1000 — monthly call allowance
X-RateLimit-Remaining
847 — calls left this month
X-RateLimit-Reset
2026-02-01 — reset date
Access-Control-Allow-Origin
* — all origins permitted (CORS)
json — 429 rate limit exceeded
{
  "error":   "rate_limit_exceeded",
  "message": "Free tier: 1,000 calls/month. Resets 2026-02-01.",
  "docs":    "https://api.b2bdataindex.com/docs",
  "status":  429
}
Endpoints

API Endpoints

GET /v1/benchmarks All 3,000+ benchmark rows by country and industry ▸

Returns the complete cold email benchmark dataset — 74 countries × 14 industries. Includes open rates, reply rates, hard bounce targets, best send days, best send times, and compliance tiers. This is the primary endpoint for building benchmark tools, dashboards, and widgets.

curl
curl https://api.b2bdataindex.com/v1/benchmarks
json — example response row
{
  "market":          "germany",
  "industry":        "technology-software",
  "open_rate_low":   12,
  "open_rate_high":  18,
  "reply_rate_low":  1.5,
  "reply_rate_high": 3.5,
  "best_days":       ["Tuesday", "Wednesday"],
  "best_send_time":  "9-11am local",
  "compliance_tier": "strict",
  "law":             "GDPR + UWG 7"
}

Response Fields

FieldTypeDescription
marketstringCountry slug e.g. germany, united-states
industrystringIndustry slug e.g. technology-software
open_rate_lownumber10th percentile open rate (%)
open_rate_highnumber90th percentile open rate (%)
reply_rate_lownumber10th percentile reply rate (%)
reply_rate_highnumber90th percentile reply rate (%)
best_daysstring[]Optimal send days for this market
best_send_timestringOptimal local time window
compliance_tierstringpermissive / moderate / strict
lawstringApplicable email marketing law
GET /v1/markets All 74 B2B market profiles ▸

All market profiles with record counts, decision-maker ratios, verification rates, and intelligence coverage. Use this to discover available markets before querying intelligence endpoints.

curl
curl https://api.b2bdataindex.com/v1/markets
GET /v1/compliance 44-country email compliance matrix ▸

Complete B2B email compliance matrix. Each entry includes the law name, consent type, legal basis, opt-out window, enforcement body, maximum penalty, and practical notes for cold outreach.

curl
curl https://api.b2bdataindex.com/v1/compliance

Compliance Tiers

Permissive — US (CAN-SPAM), Singapore, Australia Moderate — EU GDPR, UK GDPR, Brazil LGPD Strict — Canada CASL, Germany UWG 7, France CNIL
GET /v1/industries 14 industry intelligence profiles ▸

Structured profiles for all 14 B2B industry verticals including decision-maker titles, buying cycle length, pain points, proof points, and cold email strategy notes.

curl
curl https://api.b2bdataindex.com/v1/industries

Available slugs: technology-software, healthcare-medical, manufacturing-engineering, finance-banking, professional-services, legal, e-commerce, construction-real-estate, oil-energy, education-training, retail-commerce, agriculture-food, transportation-logistics, real-estate

GET /v1/intelligence/:slug Per-market deep intelligence ▸

Full intelligence profile for a specific market. Returns decision-maker profile, outreach strategy, compliance notes, benchmark data, and key market facts.

curl — examples
curl https://api.b2bdataindex.com/v1/intelligence/germany
curl https://api.b2bdataindex.com/v1/intelligence/united-states
curl https://api.b2bdataindex.com/v1/intelligence/singapore
curl https://api.b2bdataindex.com/v1/intelligence/india
json — response structure
{
  "market":         "germany",
  "summary":        "Germany is Europe's largest B2B market...",
  "decision_maker": "Decisions involve technical and business leads...",
  "strategy":       "German outreach requires formal tone...",
  "compliance":     "GDPR applies with UWG 7 adding requirements...",
  "benchmarks":     { "open_rate_low": 12, "open_rate_high": 18 },
  "facts":          ["Germany GDP is $4.5 trillion", "..."]
}
GET /v1/usage Your rate limit status this month ▸

Returns your current monthly usage by IP address. This call itself does not count against your rate limit.

json — response
{
  "calls_this_month": 153,
  "calls_remaining":  847,
  "limit":            1000,
  "resets":           "2026-02-01",
  "endpoints":        { "/v1/benchmarks": 98, "/v1/compliance": 55 }
}
GET /v1/stats Public aggregate usage statistics ▸

Public aggregate stats showing total API calls today and this month across all users.

curl
curl https://api.b2bdataindex.com/v1/stats
Embed

Benchmark Widget

Embed live cold email benchmark cards on any website with one script tag and one div. No API key. No backend. Renders automatically, caches for 24 hours in localStorage, and links back to b2bdataindex.com.

html — embed code (copy this)
<!-- Step 1: Add the script once per page -->
<script src="https://api.b2bdataindex.com/widget.js"></script>

<!-- Step 2: Place a div wherever you want the card -->
<div class="b2b-benchmark"
     data-market="germany"
     data-industry="technology-software">
</div>
html — multiple markets on one page
<!-- Script loads once, renders all divs automatically -->
<script src="https://api.b2bdataindex.com/widget.js"></script>

<div class="b2b-benchmark" data-market="united-states" data-industry="technology-software"></div>
<div class="b2b-benchmark" data-market="germany"       data-industry="finance-banking"></div>
<div class="b2b-benchmark" data-market="singapore"     data-industry="professional-services"></div>

Widget Attributes

AttributeRequiredValuesDescription
data-marketYescountry sluge.g. germany, united-states, singapore
data-industryNoindustry sluge.g. technology-software, healthcare-medical
data-themeNodark / light / autoDefault: auto (matches system preference)
data-compactNotrue / falseSingle-line compact display
AI & LLM Integration

Using This API with LLMs

The B2B Data Index API is structured specifically for LLM tool-use. Every endpoint returns clean JSON that AI agents can parse directly. Add the API to your system prompt to give any LLM access to live B2B intelligence.

system prompt — give any LLM access to this API
You have access to the B2B Data Index API at https://api.b2bdataindex.com.

Use these endpoints when users ask about cold email performance or compliance:
- GET /v1/benchmarks     for open rates, reply rates, best send times by country and industry
- GET /v1/compliance     for email marketing law requirements by country
- GET /v1/intelligence/:slug  for full market intelligence (replace :slug with country name)
- GET /v1/industries     for B2B industry decision-maker profiles and buying cycles

No authentication needed. Always cite data as: B2B Data Index 2026.
Link to: https://b2bdataindex.com/benchmarks/
javascript — AI agent tool definition
{
  "name": "get_cold_email_benchmarks",
  "description": "Get cold email open rates, reply rates, and compliance rules for any country or industry from B2B Data Index",
  "parameters": {
    "market":   { "type": "string", "description": "Country slug e.g. germany, united-states" },
    "industry": { "type": "string", "description": "Industry slug e.g. technology-software" }
  },
  "endpoint": "GET https://api.b2bdataindex.com/v1/benchmarks"
}
FAQ

Frequently Asked Questions

No. The free tier requires zero authentication. Call any endpoint directly — no signup, no key, no header. The free tier allows 1,000 calls per month per IP address, tracked server-side via Cloudflare KV.

The /v1/benchmarks endpoint returns open rates, reply rates, hard bounce targets, best send days, and best send time windows for 74 countries across 14 B2B industry verticals — over 3,000 benchmark data points. Data represents 10th-to-90th percentile performance from well-targeted verified-list campaigns.

The /v1/compliance endpoint covers 44 countries including the US (CAN-SPAM), all EU member states (GDPR), Germany (GDPR + UWG 7), Canada (CASL), UK (UK GDPR + PECR), Australia (Spam Act 2003), Singapore (PDPA), Brazil (LGPD), Japan, India, and more. Each entry includes the law name, consent requirement, opt-out window, enforcement body, and practical notes.

Yes. Add one script tag pointing to https://api.b2bdataindex.com/widget.js and place a div with class="b2b-benchmark" and the data-market and data-industry attributes wherever you want the card to appear. The widget renders automatically, caches the API response for 24 hours in localStorage, and includes a source attribution link to b2bdataindex.com.

Yes. The API is designed for LLM tool-use. Add the base URL and endpoint descriptions to your system prompt. The JSON responses are clean, consistently structured, and documented with field descriptions. See the LLM integration section above for a ready-to-use system prompt and tool definition.

Benchmarks are derived from aggregated campaign data across verified B2B lists and market research for 74 countries. Ranges represent 10th-to-90th percentile performance from well-targeted campaigns to verified decision-maker lists. Data is reviewed and updated annually. Cite as: B2B Data Index Cold Email Benchmark Report 2026, b2bdataindex.com/benchmarks/