Integrations

# How to Use the SMB Sales Boost API

By SMB Sales Boost Team. 

> ✓ Quick Answer
> 
> All paid plan subscribers can access the SMB Sales Boost REST API. Generate an API key from Account Settings > API tab, then use our endpoints to search leads, export data, manage filter presets, keyword lists, email schedules, and more - all programmatically.

## How to Use the SMB Sales Boost REST API

The SMB Sales Boost API gives you full programmatic access to leads, exports, filter presets, keyword lists, email schedules, export formats, credit purchases, and account management. All paid plans include API access.

### Getting Started

1. **Ensure you have a paid plan** \- API access is available on Starter, Growth, Scale, Platinum, and Enterprise plans
2. **Navigate to Account Settings** by clicking your profile icon
3. **Click the API tab** to access your API management dashboard
4. **Generate an API key** \- click "Generate API Key" to create your authentication credential
5. **Copy your API key** \- store it securely; it will not be shown again after you leave the page
6. **Review the full API documentation** at </docs/api> for detailed endpoint references

### API Authentication

Include your API key as a Bearer token in every request:

```
Authorization: Bearer your_api_key_here

```

### Core Endpoints

**Leads**

* **GET /api/v1/leads** \- Search and filter leads with keywords, location, industry, date ranges, and more
* **POST /api/v1/leads/export** \- Export leads to CSV, JSON, or XLSX with custom format options

**Filter Presets**

* **GET /api/v1/filter-presets** \- List your saved filter presets
* **POST /api/v1/filter-presets** \- Save a new filter preset for reuse

**Keyword Lists**

* **GET /api/v1/keyword-lists** \- List your keyword lists
* **POST /api/v1/keyword-lists** \- Create a new keyword list

**Email Schedules**

* **GET /api/v1/email-schedules** \- List your automated export schedules
* **POST /api/v1/email-schedules** \- Create a recurring email export

**Export Formats**

* **GET /api/v1/export-formats** \- List your custom export formats
* **POST /api/v1/export-formats** \- Create a custom export format with field mappings

**Credits and Billing**

* **POST /api/v1/purchase-credits** \- Purchase additional permanent credits
* **GET /api/v1/auto-top-up** \- View auto top-up configuration
* **PATCH /api/v1/auto-top-up** \- Configure automatic credit top-up

**Account**

* **GET /api/v1/me** \- View your profile, plan, and credit balance
* **PATCH /api/v1/me** \- Update profile fields
* **GET /api/v1/export-history** \- View past exports with download links

**AI Features**

* **POST /api/v1/ai/suggest-categories** \- AI-powered category suggestions based on your business
* **POST /api/v1/ai/generate-keywords** \- Trigger AI keyword generation

### Credit-Smart Querying

The API supports `maxCredits` and `maxResults` parameters on lead searches and exports to help you control credit usage:

* **maxCredits** \- Set a cap on how many credits to spend per query (only new leads cost credits)
* **maxResults** \- Limit total results returned
* **Previously exported leads are free** to re-query or re-export

### CRM Integration Examples

**Salesforce:** Pull leads via GET /api/v1/leads, then create Lead records through Salesforce's REST API.

**HubSpot:** Fetch leads from SMB Sales Boost and create contacts in HubSpot using their Contacts API.

**Custom CRM / Database:** Build a scheduled sync that pulls fresh leads daily and inserts them into your system.

### Rate Limits

API requests are rate-limited based on your plan tier. Check the [API documentation](/docs/api/rate-limits) for current limits and best practices.

---

**Ready to Find Your Next Customers?** Get access to newly registered business leads updated every 5 minutes. [Get Started](/?utm%5Fsource=content&utm%5Fmedium=cta)

---

## Related Articles

* [How to Use the MCP Server](/support/how-to-use-mcp-server)
* [What Data Is Included in Exports](/support/what-data-is-included-in-exports)
* [How to Export Leads to CSV](/support/how-to-export-leads-to-csv)
* [Understanding Credits and How They Work](/support/understanding-credits)