Credits & Modules

How Credits Work

BounceWatch uses a credit-based pricing system. Each API request consumes credits based on the data modules you request.

Base data is always included and costs 10 credits. Additional enrichment modules add to this base cost.

Credit Pricing

Module	Credits	Description
Base	10	Always included - company identity, contact, location
Business	+6	Industry, business model, services, market positioning
Technology	+4	Tech stack, frameworks, tools (100+ technologies)
Funding	+10	Investment history, investors, valuation
Team	+6	Leadership, employees, hiring activity
Signals	+16	39 signal types across 8 categories
Competitors	+8	Similar companies, competitive landscape

Maximum cost per request: 60 credits (Base + all enrichment modules)

Enrichment Modules

Base Data (10 credits)

Always included with every request.Data Points:

Company name and domain
Description and tagline
Founded year
Employee count
Headquarters location
Social media links (LinkedIn, Twitter, etc.)
Contact information
Legal entity details

GET /api/v1/company/stripe.com
# Returns base data only - 10 credits

Business (+6 credits)

Company’s business context and market positioning.Data Points:

Industry classification
Business model
Target market
Services offered
Value proposition
Market positioning

GET /api/v1/company/stripe.com?enrich=business
# 16 credits (10 base + 6 business)

Technology (+4 credits)

Complete technology stack analysis.Data Points:

100+ technology categories
Programming languages
Frameworks and libraries
Cloud infrastructure
Analytics tools
Marketing tools
Security solutions

GET /api/v1/company/stripe.com?enrich=technology
# 14 credits (10 base + 4 technology)

Funding (+10 credits)

Investment history and financial data.Data Points:

Funding rounds (Seed, Series A, B, C, etc.)
Total funding amount
Latest valuation
Investors list
Investment dates
Lead investors

GET /api/v1/company/stripe.com?enrich=funding
# 20 credits (10 base + 10 funding)

Team (+6 credits)

Team composition and hiring activity.Data Points:

Key team members
Leadership profiles
Employee growth trends
Hiring status
Open positions
Department breakdown

GET /api/v1/company/stripe.com?enrich=team
# 16 credits (10 base + 6 team)

Signals/Highlights (+16 credits)

39 signal types across 8 categories.

Category	Types	Examples
`business`	8	Partnership announced, major customer win, expansion announced, new office, regulatory approval, certification achieved
`risk`	7	Layoffs, shutdown announced, shutdown risk, senior departure, pivot
`milestone`	5	IPO announced, acquired, acquired a company, acquisition rumour
`product`	4	Product launched, feature shipped, mobile app released, homepage repositioned
`growth`	4	Growth metrics, revenue metrics, web traffic moved, LinkedIn following moved
`hiring`	4	Senior hire, open roles, open role in a key function, headcount moved
`event`	4	Event attendance, award received, programme acceptance, news mention
`funding`	3	Raised a round, signalled intent to raise, grant received

Some types are unconfirmed — rumours or inferences rather than announcements (fundraising_intent, acquisition_rumor, shutdown_risk, and others). They are flagged as such in the response; report them with that qualification.

GET /api/v1/company/stripe.com?enrich=signals
# 26 credits (10 base + 16 signals)

Competitors (+8 credits)

Competitive landscape analysis.Data Points:

Similar companies
Direct competitors
Market alternatives
Competitive positioning

GET /api/v1/company/stripe.com?enrich=competitors
# 18 credits (10 base + 8 competitors)

Use Case Combinations

Investor Due Diligence
Sales Prospecting
Competitive Analysis
Full Profile

26 credits

GET /api/v1/company/startup.com?enrich=funding,team

Perfect for:

Funding history analysis
Team composition review
Investment decision support

36 credits

GET /api/v1/company/prospect.com?enrich=business,technology,signals

Perfect for:

Lead qualification
Tech stack identification
Growth potential assessment

28 credits

GET /api/v1/company/competitor.com?enrich=business,technology,competitors

Perfect for:

Market research
Competitive positioning
Technology benchmarking

60 credits

GET /api/v1/company/target.com?enrich=business,technology,funding,team,signals,competitors

Complete company intelligence with all available data.

Checking Your Credits

curl -X GET "https://api.bouncewatch.com/api/v1/account/credits" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch('https://api.bouncewatch.com/api/v1/account/credits', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(`Credits remaining: ${data.data.credits.balance}`);

response = requests.get(
    'https://api.bouncewatch.com/api/v1/account/credits',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(f"Credits remaining: {response.json()['data']['credits']['balance']}")

$ch = curl_init('https://api.bouncewatch.com/api/v1/account/credits');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_API_KEY']);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "Credits remaining: " . $data['data']['credits']['balance'];

Response

{
  "success": true,
  "data": {
    "credits": {
      "balance": 21000,
      "used": 4000,
      "limit": 25000,
      "total_purchased": 0,
      "percentage_used": 16,
      "resets_at": "2026-02-01T09:14:22.000000Z"
    }
  }
}

Credits do not roll over. Each billing period starts at your plan’s limit, whatever was left of the previous one. Plan for the allowance, not for a balance that accumulates.

Credit Best Practices

Request Only What You Need

Start with base data and add enrichments as needed. Don’t request all modules if you only need funding data.

Cache Responses

Company data doesn’t change frequently. Cache responses for 24 hours to save credits.

Monitor Usage

Poll GET /account/credits — it returns balance, used, limit, percentage_used and resets_at. Webhooks fire on enrichment events only; there is no credit-threshold event to subscribe to.

Batch Wisely

Group similar enrichment requests to optimize credit usage.

Insufficient Credits

If you don’t have enough credits for a request, you get 402 Payment Required:

{
  "success": false,
  "error": "insufficient_credits",
  "message": "Insufficient credits for enrichment",
  "credits_required": 26,
  "credits_available": 15
}

Some responses also carry the older required_credits / available_credits / credits_needed aliases. New integrations should read credits_required and credits_available, which are present everywhere.

Need More Credits?

Upgrade your plan → the new allowance is added on top of what is left of the current one

View Complete Response Structure

See exactly what data each module returns →

Getting Started

Core Concepts

AI Agents (MCP)

API Reference

API Playground

How Credits Work

Credit Pricing

Enrichment Modules

Use Case Combinations

Checking Your Credits

Credit Best Practices

Request Only What You Need

Cache Responses

Monitor Usage

Batch Wisely

Insufficient Credits

Need More Credits?

View Complete Response Structure

​How Credits Work

​Credit Pricing

​Enrichment Modules

​Use Case Combinations

​Checking Your Credits

​Credit Best Practices

Request Only What You Need

Cache Responses

Monitor Usage

Batch Wisely

​Insufficient Credits

Need More Credits?

View Complete Response Structure

How Credits Work

Credit Pricing

Enrichment Modules

Use Case Combinations

Checking Your Credits

Credit Best Practices

Insufficient Credits