Skip to main content

Managing Credit Usage for High-Volume API Requests

Freddy Rodriguez avatar
Written by Freddy Rodriguez
Updated over 2 months ago

If you’re planning to run large API requests—like searching for employees, enriching lead lists, or pulling detailed records across companies—it’s easy to underestimate how quickly credits can be used.

This article walks through how usage is calculated in high-volume scenarios and what you can do to stay in control, especially while testing or iterating your setup.

How Credit Usage Adds Up

Some endpoints (like Person Search or Employee Listing) charge per result returned. For example:

  • 1 API call that returns 100 employees

  • At 3 credits per result

  • = 300 credits used in a single call

This is expected behavior—but it can catch users off guard if you’re not aware of the default settings, such as page_size.

💡 Best Practices to Prevent Unexpected Charges

Here are a few ways to better manage your usage:

✅ 1. Set

page_size

to Control Volume

By default, page_size is set to 100—meaning up to 100 records could be returned in one call.

To limit that, you can set a smaller value:

{

"page_size": 25

}

Choosing a smaller page_size (like 10, 25, or 50) is great for testing in smaller chunks and staying within your credit balance.

✅ 2. Avoid Duplicate or Iterative Calls

Even if your parameters are the same, each API call is charged separately.

Examples:

  • Running the same role or person search query more than once

  • Repeating a company profile lookup during iteration or troubleshooting

Each call deducts credits based on the number of results returned—even if the data looks similar.

✅ 3. Review Your Logs (We Can Help!)

If you notice a bigger credit drop than expected, our team is happy to help.

👉 Just send us a message or email [email protected], and we can review your recent usage logs to help clarify what happened—and guide you on optimizing future calls.

Summary: Common Credit Usage Triggers

Factor

Impact

High page_size

More results returned per call

Per-result billing

Charges increase with result volume

Enrichment enabled

Adds credits per returned record

Repeated calls

Each is billed separately

Final Tip

If you’re working on backend automation or scaling your API calls, try testing with smaller datasets first. It gives you better predictability and helps avoid using more credits than intended.

We’re here to help you make the most of your plan—with no surprises.


Did this answer your question?