Credits

ImportYeti charges data credits for most API calls. These are the credits you buy.

How charging works

When a call costs credits, the response includes:

• requestCost — how many data credits this call used
• creditsRemaining — your balance after the call

Cost is scaled to how many records come back. For example, “1 per 10 records” means 10 results cost 1 credit, 25 results cost 2.5 credits.

Cost follows the records, not the fields. Narrowing a response with fields or exclude returns less data for the same price — ask for fewer records to spend less.

A few calls are free — company search, supplier search, and checking when the database was last updated. Those return requestCost: 0. See Search Credits for the one case where search is billed.

Search Credits

Search endpoints are generally not charged separately, as they are typically used as a gateway to other endpoints where the full data is retrieved. We also don’t want to penalize users for searches that return no results.

However, if your integration uses a search endpoint as the primary way of retrieving data — without subsequently calling the corresponding data endpoint — search results are charged at 0.1 credits per record returned.

For example:

• 1 record returned = 0.1 credits
• 10 records returned = 1 credit
• 100 records returned = 10 credits
• No results returned = 0 credits

Typical workflow:

1. Use the search endpoint to find the company or record you’re looking for.
2. Use the corresponding endpoint to retrieve the full data.

This means that search is effectively free when it’s being used to identify records that you then retrieve through the relevant data endpoint. If search is being used on its own to retrieve records, the 0.1-credit-per-record rate applies.

Here’s what this looks like in practice: if your search requests stop working, just reach out to us. We’ll make the necessary switch on our end so you can continue using the search endpoint as intended.

When you run out

Out of credits returns HTTP 403 (not 402):

{
  "statusCode": 403,
  "message": "Not enough credits",
  "error": "Forbidden"
}

Buy more data credits →

Cost table