canonical: https://jentic.com/apis/bouncewatch.com/bouncewatch

# BounceWatch API

The BounceWatch API enriches companies by domain with firmographic and buying-signal data, and tracks the credits each lookup spends. A domain enriched within the last 24 hours returns instantly at no extra credit cost, and batch enrichment jobs can be polled for status and results. Account endpoints report your credit balance, usage, and request history, and let you register a webhook so results are posted back to you.

## For AI agents

Enrich a company by its domain, read buying signals, and check credit balance and usage. Batch enrichment results can be retrieved by job id.

## Scope

Does not handle email verification, outbound email sending, or CRM record storage. Use for company enrichment and buying-signal data only.

## Capabilities

- Enrich a company by its domain with firmographic and buying-signal data
- Read buying signals that flag when a company is in-market
- Check your remaining enrichment credits before spending them
- Retrieve the results of a batch enrichment job once it completes
- Review your account's recent request history and usage
- Register a webhook URL so BounceWatch posts enrichment results back

## Use cases

### Agent-driven company enrichment

An AI agent that qualifies inbound leads can call BounceWatch with a company domain and receive firmographic and buying-signal data in one response. A domain already enriched within the last 24 hours comes back instantly at no credit cost, so repeated lookups in a session stay cheap.

Example prompt: Enrich the company at acme.com and return its firmographic fields and current buying signals

### Credit-aware batch enrichment

A workflow that enriches a list of domains can start a batch, poll its status until it finishes, and then pull the results, checking the credit balance first so it never spends more than the account allows. BounceWatch returns the batch results keyed by the job id you polled.

Example prompt: Check the credit balance, then retrieve the results for batch job batch_123 once its status is complete

### In-market signal monitoring

A sales agent can watch for companies entering the market by reading the buying signals BounceWatch attaches to an enriched company, then record the account usage so the team sees how many lookups the monitoring consumed.

Example prompt: Enrich target-company.com, read its buying signals, and report whether it is currently in-market

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/company/{domain}` | Get enriched company data for a domain |
| GET | `/enrichment/{batch_id}/status` | Check the status of a batch enrichment job |
| GET | `/enrichment/{batch_id}/results` | Retrieve batch enrichment results |
| GET | `/account/credits` | Get the current credit balance |
| POST | `/account/webhook` | Set the webhook URL for results |

## Key resources

- **Company** — Enrich a company by its domain and read its buying signals
- **Enrichment** — Check batch enrichment status and retrieve batch results by job id
- **Account** — Read credit balance, usage, request history, and set a webhook URL

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 68 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 74 / 100
  - AI-Readiness & Agent Experience: 47 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 92 / 100
- **View full report:** https://jentic.com/apis/bouncewatch.com/bouncewatch/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring BounceWatch by hand means handling its API-key header, its credit accounting, and the poll-until-complete loop for batch jobs yourself. Through Jentic you install once, import BounceWatch from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which BounceWatch operations the agent may call, such as company enrichment and credit reads, so an account operation like setting your webhook URL is not included unless you add it.
- **Credential handling:** Your BounceWatch API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'enrich a company by domain', and Jentic returns the matching BounceWatch operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Clearbit** — Clearbit enriches companies and contacts; BounceWatch adds buying-signal data keyed to a domain.
- **People Data Labs** — People Data Labs sells company and person datasets; BounceWatch focuses on in-market buying signals.
- **FullContact** — FullContact resolves identity and enriches contacts; BounceWatch scores company buying intent.
- **Apollo.io** — Apollo handles sales engagement; BounceWatch supplies the enrichment and intent signal that triggers it.

## FAQ

### What authentication does the BounceWatch API use?

The BounceWatch API authenticates with an API key sent in the X-API-Key header, per its OpenAPI spec. The health-check endpoint needs no credential, so you can point an uptime monitor at it without spending credits.

### Is there a BounceWatch MCP server?

You do not need an MCP server to give your agent BounceWatch. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls the enrichment and account operations. Nothing extra is loaded into the agent's context until an operation is actually used.

### Can I limit what my agent is allowed to do with the BounceWatch API?

Yes. Write a rule that allows only the company-enrichment and credit-read operations, so the agent can look up domains and check its balance but cannot change your account webhook URL, and every call it makes is logged.

### Can I retrieve batch enrichment results with the BounceWatch API?

Yes. Start a batch, poll the enrichment status endpoint until it reports complete, then read the data from the matching results endpoint. Results for a domain enriched in the last 24 hours return instantly at no extra credit cost.

### What are the rate limits for the BounceWatch API?

The OpenAPI spec does not publish a numeric rate limit. Enrichment spends credits per lookup, so the practical ceiling is your credit balance, which you can read from the account credits endpoint before a run.

### How do I enrich a company with the BounceWatch API through Jentic?

Search Jentic for 'enrich a company by domain', and it returns the BounceWatch company-lookup operation with its input schema. Pass the domain, read back the firmographic fields and buying signals, and the credit cost is reflected in your balance. To run it on your own infrastructure, install Jentic One from its GitHub repo.