API credits are consumed based on results returned — not requests made. You're charged for what you actually receive, not for making the call itself.
Profile & Company Fetch
Every profile or company record returned by the API costs 1 credit. If you fetch 10 profiles in a single request and all 10 are returned successfully, that's 10 credits. If your request returns 0 results (e.g., no match found), no credits are charged.
Network Mapper
The Network Mapper charges 1 credit per connection found. If a mapping run discovers 47 connections for a given person or company, that's 47 credits.
Search queries are always free
Running a search to find profiles or companies before fetching them doesn't consume credits — only the fetch itself does.
Social Engagement Endpoints
The social engagement endpoints follow the same results-based logic — you're only charged when data is actually returned.
Profile Refresh
Costs 3× the standard rate: 3 credits per profile record returned. So refreshing 10 profiles costs 30 credits.
Post Fetch
Charges based on the number of posts returned, in blocks of 10:
1 credit for 1–10 posts returned
2 credits for 11–20 posts returned
3 credits for 21–30 posts returned
And so on, up to a maximum of 10 credits for 91–100 posts (the single-request cap)
The default response returns up to 10 posts; you can request up to 100 in a single call.
Comments, Reactions, and Reshares
Each of these endpoints charges a flat 1 credit per call — regardless of how many items are returned:
comments— 1 credit for all comments returnedreactions— 1 credit for all reactions returnedreshares— 1 credit for all reshares returned
As with all other endpoints, a call that returns no results costs 0 credits.
A few examples:
Action | Credits Used |
Refresh 1 profile | 1 |
Refresh 20 profiles | 20 |
Fetch posts, 8 returned | 1 |
Fetch posts, 15 returned | 2 |
Fetch posts, 0 returned | 0 |
Fetch all comments on a post | 1 |
Fetch all reactions on a post | 1 |
Fetch all reshares on a post | 1 |
Credits only count on success
If a request fails (anything other than a 200 response), no credits are deducted.
Included credits and overages
Each plan includes a monthly credit allowance that resets at the start of every billing cycle — credits don't roll over. Once you've used your included credits, additional usage is billed at your plan's overage rate.
For example: on the Premium 50 plan ($99/mo, 1,000 credits included at $0.10/credit), if you use 1,400 credits in a month, your invoice will be $99 + 400 × $0.10 = $139.