Does Bebop Have an API? Use our Blackpearl Platform API

Blackpearl Platform runs as a standalone service, with its own dashboard, projects, and API keys. Your developers call it directly to pull that data into your CRM, data storage system , or internal tooling, and the team can rebuild the audiences you already run in Bebop as Blackpearl projects.

One scope limit before you plan anything: the Blackpearl Platform supports prospecting into the United States only. Targeting outside the US isn't supported yet

What is the Blackpearl Platform, and how is it different from Bebop?

Bebop and Bebop RTS (Ready-to-Sell) are the products your team work 'within'. Prospecting, guidance, and enrichment come to you through the Bebop app and the Bebop RTS service.
The Blackpearl Platform runs separately, with its own dashboard, projects, API keys, and usage. It publishes the same underlying data and intelligence as an API.
Bebop delivers data to your team through direct access; Blackpearl Platform delivers it to your systems.
Bebop itself does not have the ability to automatically deliver data outside the service, Bebop RTS has the capability to connect to specific CRM's which our team assist you with building. To put Bebop's data inside your CRM, data storage, connect to another AI tool or internal tooling, you can build against the Blackpearl Platform.

What can we do with the Blackpearl Platform API?

One API key gives you access to:

Prospecting for companies and people discovery
Account and website research, turned into structured data
Contact and company enrichment to fill in the information you're missing with existing prospects
Sales guidance and branded documents, generated for a specific account or deal stage
Reviewable outreach copy, ready for a human to approve before it goes anywhere
A feedback loop: record what happened, and future runs improve

What the API won't do

The API supplies data and intelligence. It does not directly send outreach on your behalf.

There's no send endpoint, no sequencer, and no automatic recipient enrolment.
Blackpearl marks every audience and contact list you pull back as not authorized for outreach, even after your team reviews it. Reviewing curates a list, but it does not grant consent.
You own consent, suppression, and lawful-basis checks. Whatever delivery tool you connect on top enforces them: your email platform, your CRM, your sequencer.

How is an integration structured?

A typical integration runs in three steps. Your application requests research, prospecting, or enrichment. Blackpearl returns structured data, or a job ID you poll until the work finishes. Your code writes that data into your CRM, warehouse, or email tool.

Any system that can call an HTTPS endpoint can connect: a CRM such as HubSpot or Salesforce, a data warehouse, an internal service, a workflow tool, or an AI coding assistant building against the published documentation.

Every account has three layers:

Organization: billing, plan, and overall access sit here
Project: an isolated environment for keys, usage, and jobs. Most customers run separate projects for development and production so one never affects the other
API key: the credential your application sends, scoped to one project

Requests authenticate with a standard bearer token:

Authorization: Bearer YOUR_API_KEY

Each key works inside one project only. No project can see or touch another project's data, even by guessing an ID.

What can we connect to? API capabilities

Capability	What it gives you
Playbooks	Stage-aware sales guidance for a specific account
Prospecting	Discover and qualify companies and people against a target profile, with evidence
Audiences	Scored discovery plus a reviewable, exportable candidate list
Account Research	Structured company intelligence for any domain
Brands	A researched, versioned brand guideline of your business
Offers	A structured record of what you sell
Campaigns	A container that ties targeting, brand, and offer together
Documents	Branded sales collateral, delivered as PPTX, DOCX, or PDF
Outcomes	A ledger for recording results and reading back performance data

Three newer capabilities remain in preview: contact and company enrichment, a bounded website crawler, and governed message-template generation. The template generator drafts copy for human review and still can't send it. Preview features work today, though their shape can change before release.

How do we get an API key?

Your account admin creates or selects a project in the console.
From API keys, generate a new key. The console shows the secret once, so store it in a secure server-side location straight away.
Send your first request with that key in the Authorization header.

Two limits to know before you start:

There's no test or sandbox mode. Every request does real work and bills for it, including requests from a development project. A development project isolates that work without simulating it.
Long-running tasks return a job, not an instant result. You get back a job ID, then poll it until it finishes. Quick lookups, like Account Research, respond right away.

What are the API rate limits, quotas, and billing rules?

Each API key has a per-minute request limit tied to your plan. Your dashboard shows the live values. We recommend not hardcoding these because they shift as your account grows.
Organizations can also set monthly usage quotas and spend caps at the project or account level. Hitting one blocks new work until the next monthly reset, or until an admin raises the limit.
Blackpearl bills on real usage once a job completes rather than on an upfront estimate. New work needs a positive account balance.

How are API keys and customer data secured?

API keys are secrets. Store them server-side only, never in a browser, mobile app, or client-side code.
Rotate a key without downtime: create a new one, switch your integration over, confirm it's working, then revoke the old one.
Blackpearl keeps job inputs and results for 30 days, then clears them. Save anything you need for longer on your own side.
AI generates the content, research, and summaries, so content can be incomplete or inaccurate. Verify anything you're about to put in front of a customer or use in a business decision.

Frequently asked questions

Does Bebop have an API?

Not on its own. The API belongs to the Blackpearl Platform, a separate platform that carries the same data and intelligence as Bebop and Bebop RTS. Your developers call it directly using an API key generated in the Blackpearl console.

What's the difference between Bebop and the Blackpearl Platform?

Bebop and Bebop RTS are the products your team works in. The Blackpearl Platform is a separate platform that publishes the same underlying data and intelligence as an API. Bebop delivers it to your people; Blackpearl delivers it to your systems.

Can we integrate Bebop with our CRM, HubSpot, Salesforce, or another platform?

Yes, by building against the Blackpearl Platform API rather than Bebop directly. Blackpearl returns structured data your code writes into your CRM, warehouse, or email tool. There's no send endpoint, so delivery stays with your own platform.

Which regions can we prospect into through the API?

North America only, which today means the United States. If you need prospects outside the US, talk to the team before you build against the API.

Does this send emails or messages for us?

No. It prepares data, research, and draft copy. Your own email platform, CRM, or sequencer handles delivery.

Is there a sandbox we can test in?

There's no separate sandbox. A development project keeps test work isolated from production, but every call still runs for real and is billed.

What happens if we go over our usage limit?

New work pauses until the quota resets, which happens monthly, or until your admin raises the cap. Your dashboard shows current usage and remaining capacity.

Can our developers connect an AI coding assistant, like Claude, to build against this API?

Yes. Blackpearl publishes a read-only documentation server your coding agent queries for current answers instead of guessing at the API shape.

How long is our data kept?

Blackpearl holds job inputs and results for 30 days after creation. Export anything you need beyond that.

What if a key is exposed or compromised?

Generate a replacement key immediately, update your integration, then revoke the old one. There's no grace period once a key is revoked.

Do the lists or contacts we pull back come pre-cleared for outreach?

No. Blackpearl marks every result, reviewed or not, as not authorized for outreach. Consent and suppression checks stay on your side.

Who do we contact for API or integration help?

If something isn't working as expected, reach the team at feedback@bebop.ai, or visit https://api.blackpearl.com/ for the full developer documentation.