What counts as an API request?

An API request is the credit we charge for enriching data or prospecting new leads. Depending on the endpoint you are using, API calls are counted differently.

Enrichment API

One API call is used per request made, meaning when an email address or website domain is queried against any of the Enrichment API endpoints. A personal email, a corporate email, or a website domain lookup would all count equivalently as one API request. API requests can be by way of direct access (ex. cURL command), your own application, or via a prebuilt integration (ex. Salesforce or Marketo).

Clearbit only counts requests which return 200, 201, 202, or 404 status codes. You can see what the error codes translate to here. In addition, only unique requests are counted each billing period - meaning if 'alex@clearbit.com' were queried two days in a row, it would still only count as a single API request.

For Enrichment API details, visit our docs page.  

Prospector API

With Clearbit’s Prospector API, one API call is used per unique result that Clearbit is able to return. This means that when you search for a company to find its contacts, the endpoint will give you an array of people who work at the company; one Prospector API call will be used for each person’s contact that is returned to you.

For Prospector API details, visit our docs page.

Discovery APIs

With Clearbit’s Discovery API, one API call is used per unique result that Clearbit is able to return. This means that when you make a request with a specific criteria, the endpoint will give you an array of companies that fit the bill; one Discovery API call will be used for each company that is returned to you.

For Discovery API details, visit our docs page.

Note: Unique requests are only counted once every 30 days against your allotment, so if you didn’t store the data properly or need to re-run a series of requests for any reason, those won’t count against your monthly quota. As such, you’re free to make identical API requests over and over during the same billing period, which is often very helpful for developers who’re testing out an integration.