Token Usage

Tokens are organization usage credits. They are used by features that perform captured searches, recurring tracker checks, or AI Visibility checks.

Where to review usage

Billing

Open Billing to see token balance cards, the Token Usage chart, the current plan, next billing date, top-ups, subscription history, and payment history.

Sidebar token meter

The app sidebar shows a quick token balance for the active organization while you work.

Team Settings

Open Team Settings to review the Token Transactions ledger. It can be filtered by member, wallet type, and resource.

Active organization

Token usage is organization-level. If you belong to multiple organizations, switch to the correct organization before reviewing balances or transactions.

Missing usage data

If token data is unavailable, confirm that a organization is active and that your role has access.

How token balances work

Subscription tokens

Subscription tokens are the included tokens from your current plan. Internally, these are the resettable wallet.

They refresh to the plan allocation on each billing renewal. Monthly plans refresh monthly. Yearly plans refresh yearly and receive the annual allocation for the yearly period.

These tokens are spent first. Unused subscription tokens do not stack on top of the next renewal allocation.

Permanent tokens

Permanent tokens are extra tokens bought through Token Top-Ups. Internally, these are the permanent wallet.

They do not reset when the subscription renews. They stay available for the organization and are used after subscription tokens run out. Refunds or billing reversals can remove the related top-up tokens.

Total available

The product combines both wallets when checking whether a organization has enough tokens. A organization can still run token-using work when subscription tokens are empty if permanent top-up tokens remain.

What spends tokens

Searches

Direct Search does not spend tokens because it builds a search-engine URL and sends you out to the search engine.

Search Engine Proxy spends tokens because iSearchFrom captures and stores result pages. Each requested proxy results page adds work, so start with page 1 and add deeper pages only when needed.

Trackers

SERP Position Tracker and Ads Position Tracker spend tokens when a scheduled or manual run is created. Usage scales with the number of keywords checked in that run and the run frequency.

Tracked domains affect what the campaign reports, but token usage follows the checks the run performs.

AI Visibility

AI Visibility runs can spend tokens based on prompts, locations, platforms, and run frequency.

Estimate usage before creating campaigns

For trackers, estimate:

keywords x run frequency

For AI Visibility, usage is affected by:

prompts x locations x platforms x run frequency

Start with narrow campaigns, inspect results, then expand.

Reading the token ledger

Team Settings includes a Token Transactions table for the active organization. Use it when you need to explain why balance changed.

The table shows:

• amount: positive numbers add tokens, negative numbers spend or reverse tokens
• balance after: wallet balance after that transaction
• wallet: subscription/resettable or permanent/top-up
• resource: the tool or billing event that caused the transaction
• time: when the transaction was created

Filter by member to see who triggered usage. Filter by resource to isolate proxy searches, tracker runs, AI Visibility runs, subscription resets, orders, or refunds.

Reduce unnecessary usage

Pause stale campaigns

Pause campaigns that no longer support decisions or reports.

Start weekly

Use weekly schedules before daily schedules.

Keep AI prompts focused

Remove generic prompts that do not reveal useful brand or competitor signal.

Split broad monitoring

Use smaller campaigns by market, intent, or client instead of one oversized setup.

Load pages intentionally

Load extra proxy pages only when the first page does not answer the question.

Remove setup tests

Remove test campaigns after setup is complete.

Open in iSearchFrom

Open Billing in the app. Token usage is shown on the Billing page in the Token Usage chart and the balance cards. Open Team Settings for the detailed token transaction ledger.

Related docs

Plans, Tokens, and LimitsUnderstand plan access, limits, and recommended usage patterns.

Token Top-upsAdd extra usage capacity outside your subscription allocation.

Schedules and AlertsTune recurring campaign frequency and notifications.