Programmatic Purchase - SMB Sales Boost API

Purchase a subscription entirely via API - no web signup or onboarding required. This is ideal for AI agents and automated workflows that need programmatic access to SMB Sales Boost.

How It Works

(1) Call POST /api/v1/purchase with your email and desired plan → (2) Complete payment at the returned Stripe Checkout URL → (3) Call POST /api/v1/claim-key with your email and claim token to retrieve your API key. Your API key is also emailed to you automatically.

Step 1: Initiate Purchase

POST /api/v1/purchase
Create a new subscription purchase session. Returns a Stripe Checkout URL and a claim token. No authentication required. Rate limited to 5 requests per hour per IP.

Parameters: email (required, string), plan (required, string - "starter", "growth", "scale", "platinum", or "enterprise").

Step 2: Complete Payment

Open the checkoutUrl in a browser to complete payment on Stripe's hosted checkout page. After successful payment, the system automatically provisions your account and generates an API key.

Step 3: Claim Your API Key

POST /api/v1/claim-key
Retrieve your API key after payment is completed. No authentication required. Rate limited to 30 requests per hour per IP. If payment is still processing, returns a pending status - poll every 5-10 seconds.

Parameters: email (required, string - email used during purchase), claimToken (required, string - claim token from the purchase response).

Account Setup (Highly Recommended)

Programmatic purchases skip the onboarding wizard. To get the most out of SMB Sales Boost, configure your account via the API before searching or exporting leads:

  1. PATCH /api/v1/me - Set your company name and website
  2. POST /api/v1/ai/suggest-categories - Get AI-powered category suggestions
  3. POST /api/v1/ai/generate-keywords - Generate targeting keywords
  4. POST /api/v1/settings/switch-database - Select your lead database

API Documentation Sections

Introduction | Programmatic Purchase | Authentication | Rate Limits | User Profile | Leads | Filter Presets | Keyword Lists | Email Schedules | Export Formats | Export History | Account Settings | AI Features | Export Blacklist | Error Handling | Credits & Subscription | MCP Server | Integrations

View Full API Documentation

Ready to Find Your Next Customers? Get access to newly registered business leads updated daily. Get Started