Widget Credits & Usage
Widget credits (widget embed requests) are consumed each time the embedded widget loads on a page and makes a data API call. Understanding exactly what counts — and what doesn't — helps you manage your credit balance efficiently.
What consumes a widget credit
A credit is consumed when all three of these conditions are true:
- A page containing your widget embed loads in a visitor's browser
- The widget calls the DoesItHaveIt? API to fetch address data
- The API returns a result (successful response)
The credit is counted at the time of the API call, not at page load.
What does NOT consume a widget credit
| Scenario | Credits consumed |
|---|---|
| The widget's address search bar appears on the page but the user does not submit a search | 0 |
| A cached result is returned within 5 minutes for the same address and token | 0 |
| A failed API call (network error, server error) | 0 |
| A rejected call (invalid token, domain not allowed) | 0 |
| You viewing your own site during development on an allowed domain | 1 (normal; use a dev-environment token to track separately) |
| A bot or crawler that loads the page but doesn't execute JavaScript | 0 (widget requires JS) |
The 5-minute cache
The 5-minute result cache prevents duplicate charges when:
- A user reloads a page with a pre-configured address
- A user navigates away and immediately returns
- Multiple users view the same listing page in quick succession
The cache key is the combination of your API token and the address. Different users looking up the same address on the same token within 5 minutes share the cached result and only one credit is consumed.
Monthly allotment
Your Premium Plus subscription includes 5,000 widget embed requests per month, resetting on your billing anniversary date. Credits never expire — unused monthly allotment credits accumulate indefinitely as long as your subscription is active.
Monitoring usage
Dashboard → Billing → Widget Credits shows:
- Current balance — total available credits (included + purchased, minus consumed)
- Monthly usage chart — daily request count for the current month
- Breakdown by domain — how many requests came from each allowed domain
- Token activity — requests per token (useful if you have multiple tokens)
- Projected days remaining — estimate of how long your current balance will last at the current usage rate
Set up a credit balance warning email in Settings → Notifications. The default threshold is 10% of your monthly allotment (500 credits), but you can set a custom threshold.
Volume tiers for additional credits
When 5,000/month isn't enough, buy additional credit packs at any time:
| Pack size | Pack price | Per-request cost |
|---|---|---|
| 10,000 requests | $15.00 | $0.0015/request |
| 50,000 requests | $60.00 | $0.0012/request |
| 250,000 requests | $250.00 | $0.0010/request |
| 500,000 requests | $450.00 | $0.0009/request |
Purchased credits are added to your balance immediately and never expire.
To buy: Dashboard → Billing → Widget Credits → Buy credits.
Rollover policy
- Credits never expire — there is no use-it-or-lose-it window
- Unused monthly allotment credits accumulate indefinitely while your subscription is active
- Purchased pack credits never expire
- The oldest credits are consumed first (FIFO)
What happens at zero credits
When your widget credit balance reaches zero:
- The widget still loads on your page (it doesn't break)
- Instead of displaying address data, the widget panel shows:
"Powered by DoesItHaveIt? — service temporarily unavailable"
- The address search bar may appear, but submitting an address returns the same "temporarily unavailable" message
- No JavaScript errors are thrown — the host page continues to function normally
- The outage is invisible to your visitors as a technical error; it appears as a service message
This is a hard stop, not an overage model. You are never automatically charged for requests beyond your balance.
To restore widget functionality, purchase additional credits. The widget reactivates within a few minutes of a successful purchase.
Auto top-up
To avoid service interruption, enable automatic top-up in Dashboard → Billing → Widget Credits → Auto top-up:
- Choose a trigger threshold (e.g., balance drops below 500 credits)
- Choose a pack size to auto-purchase when triggered (e.g., always buy the 10,000-request pack)
- Confirm the payment method
Auto top-up fires automatically when your balance hits the threshold, purchases the selected pack, and sends you a confirmation email. You can disable auto top-up at any time.
For production sites with consistent traffic, setting auto top-up to trigger at 1,000 credits with a 10,000-credit pack purchase gives you plenty of buffer to react to any billing issues without experiencing a service outage.
Bundle discount
Purchasing widget credit packs and promotion credit packs together in one transaction qualifies for a bundle discount. See Promotion Credits for the full bundle tier table.