Skip to main content
API credits are consumed based on results returned, not requests made. You’re charged for what you actually receive — failed calls and empty responses cost 0 credits.

What costs credits

EndpointCost
Search Profiles, Search CompaniesFree
Fetch Profile, Fetch Company1 credit per record returned
RelationshipsFree
Network Mapper (for Partners)1 credit per non-empty response
Refresh a Profile3 credits per profile returned
Get Profile Posts, Get Company Posts1 credit per 10 posts returned (rounded up, max 10 credits per call)
Get Comments, Get Reactions, Get Reshares1 credit per call (flat, regardless of result count)

Examples

ActionCredits
Search returning 250 profiles0
Fetch 10 profiles, all returned10
Fetch 10 profiles, 0 returned0
Refresh 1 profile3
Refresh 20 profiles60
Get posts, 8 returned1
Get posts, 15 returned2
Get posts, 100 returned10
Get comments / reactions / reshares1
Any failed request (non-200)0

Plans and overages

Each plan includes a monthly credit allowance that resets at the start of every billing cycle — credits don’t roll over. Once the included credits are used, additional usage is billed at the plan’s overage rate. See Plans, Billing & API Credits and Understanding API credit overages.

Check your usage

Retrieve your team’s credit usage for the current billing period.
GET https://bee.theswarm.com/credits/usage
Authenticate with your API key in the x-api-key header.

Response

{
  "usage": 2255235
}
FieldTypeDescription
usageintegerCredits consumed in the current billing period.

Example request

curl -X GET "https://bee.theswarm.com/credits/usage" \
  -H "x-api-key: <your_api_key>"