Credits and pricing
What each call costs, and exactly which answers are charged.
You buy credits and each answer spends some. Every endpoint page shows its cost at the top.
Cost per endpoint
| endpoint | cost |
|---|---|
| Profile | 1 credit |
| Profile videos | 1 credit |
| Keyword search | 1 credit per page |
| Followers | 1 credit per page |
| Following | 1 credit per page. A hidden following list is free. |
| Audience | 20 credits, charged only when 30 or more followers are placed |
| Job results and export | free |
Coming endpoints
Followers, following and audience are not open yet. An endpoint without a price answers 503 route_not_priced and never serves for free.
Charged or free
You pay only for an answer you receive. Exactly these are charged:
| answer | status | charged |
|---|---|---|
| a success | 200 | yes |
profile of an account that does not exist (account_deactivated: true) | 200 | yes |
profile videos or followers of a private account (account_private: true) | 200 | yes |
Everything else is free: every 4xx and 5xx, timeouts, overload refusals and bad requests. A request you cancel by closing the connection is not charged, even if the answer was ready.
Reading your balance
Every answer carries credits_remaining. A request your key cannot cover gets 402 insufficient_credits with needed_credits, and is not charged:
{"success":false,"error":"insufficient_credits","errorStatus":402,"message":"this key does not have enough credits for this request","credits_charged":0,"credits_remaining":0,"needed_credits":1}Top up in the dashboard.