Credits: what they pay for and where yours went
One balance of credits pays for lobstr.io operations (a fixed price per call) and batches (a price per result). Your plan's credits, your balance, and where they went.
Credits pay for everything on lobstr.io, from one balance: an operation's calls and a batch's results.
What a credit pays for
Each operation has a fixed price per call, whatever the call brings back: 1 credit for a Google Maps place, 20 for a page of 20 places, 100 for a Google News search. The price is on the operation's page in the store.
A failed call is free, whoever is at fault, and so is an empty page for most searches. See Operations.
Your plan's credits
| Free | Starter | Pro | Team | |
|---|---|---|---|---|
| A month | $0 | $20 | $100 | $500 |
| Credits a month | 100 | 10,000 | 100,000 | 1,000,000 |
| 1,000 credits | $2 | $1 | $0.50 |
Paid yearly, a plan costs 20% less. Your credits refresh each month with your plan, and unused credits don't roll over. Above 1,000,000 credits a month: talk to us. The whole comparison is on the pricing page.
By default, all your credits are there from the first day of the cycle. You can also release them a little each day: see Monthly or daily credits.
Your balance
Your credits left are at the bottom of the sidebar in the app, with when they refresh. Billing shows your plan, its credits used and its next renewal.
From code, GET /v2/balance answers your credits left and your plan, for free.
Where your credits went
Usage, in the sidebar, compares a period with the one before it (7 days, 30 days, by month): credits used, runs, credits left this cycle, credits per day. Where they went lists them by name (a batch, an operation) or by type (a scraper, an operation); an operation's row opens its calls.
For one run of a batch, its Credits tab splits what it cost by function: the results themselves, each enrichment, each extra. Compare the average cost per result of two runs: if it jumped, an extra was turned on between them.
When you run out
- An operation refuses the call before it runs, and charges nothing.
- A batch stops its run, or pauses it until your credits come back, as its If credits run out setting says.
To get credits back right away, reset your billing cycle: your plan renews now with all its credits. Auto billing reset does it for you when your credits run low. Or upgrade: an upgrade is prorated, so you pay only the difference.