company logo

Help center

Go to Rank Prompt
Powered by
All collectionsAccount & BillingCredit Usage

Credit Usage

Track your credit balance, view usage history, and understand how credits are consumed in Rank Prompt.

Credit Usage

The Credit Usage page shows exactly how many credits you have, how you've used them, and where your credits come from. Stay on top of your balance to avoid running out during important tasks.


Accessing Credit Usage

From the sidebar, click your profile icon → Credit Usage.


Credit Overview

Available Credits

Total credits you can use right now:

  • Available Credits: Monthly + Top-up combined

  • This number decreases as you use credits

Credit Breakdown

Source

Description

Monthly Credits

From your subscription plan, resets each billing cycle

Top-Up Credits

Purchased separately, never expire

Visual Cards

The page shows three main stats:

  1. Available Credits: Total usable now

  2. Monthly Left: Remaining from current cycle

  3. Top-Up Left: Remaining purchased credits


Credit Sources

Monthly Plan Credits

Credits included with your subscription:

Plan

Monthly Credits

Starter

150

Pro

500

Agency

1,000

Agency Plus

2,000

Monthly credits:

  • Reset at each billing cycle

  • Don't roll over to next month

  • Use them or lose them!

Top-Up Credits

Additional credits you purchase:

  • Available in packs (50, 100, 200 credits)

  • Never expire

  • Used after monthly credits are depleted

  • Purchase anytime from Plans & Billing

Bonus Credits

Special credits from promotions:

  • Trial bonus (50 credits)

  • Referral bonuses

  • Promotional offers


AI Budget (Agent Credits)

AI Budget is a separate balance that powers AI features: the AI Agent copilot, inline content editing in the article editor, and AI image generation. You top it up by converting report credits, so it draws from the credits you already have rather than a separate purchase.

What Uses AI Budget

  • AI Agent conversations (the copilot that helps manage brands, run reports, and answer questions about your visibility data)

  • Inline content editing in the article editor

  • AI image generation

  • Available in brand context and, on Agency Plus, in agency-wide context

What Does NOT Use AI Budget

  • Visibility reports, scheduled reports

  • Article generation

  • SEO audits

  • Outreach actions

These all use regular credits (monthly or top-up).

Topping Up AI Budget

You add AI Budget by converting report credits, not by buying a separate pack. When your balance runs low, the app prompts you to convert credits to AI Budget. Conversion rates:

Report Credits

AI Budget

20 credits

$5

50 credits

$15

120 credits

$40

Higher-volume conversions get a better rate. If you do not have enough credits to convert, the app points you to get more credits first.

AI Budget added this way is cycle-expiring: it is meant to be used in the current billing cycle and resets when your plan renews, the same as your monthly plan AI budget. If you bought permanent AI Budget top-ups in the past, that grandfathered balance still never expires, but new permanent top-ups are no longer sold.

Bring Your Own Key (BYOK)

Connect your own OpenAI API key in Agent Settings to use your own OpenAI account for agent conversations. When BYOK is active, agent usage does not consume platform AI Budget.


Credit Log

Viewing Usage History

Switch to Credit log tab to see detailed history:

Column

Description

Date

When credits were used

Action

What consumed credits

Credits

Amount used

Balance

Remaining after action

Common Actions

Action

Credits Used

Analyze 1 prompt

1 credit (standard bundle); +1 per premium platform per prompt

Generate AI article

10 credits

Lighthouse SEO audit

1 credit

Competitor SEO audit

1 credit

Technical SEO check

Free

Lead widget report

The report's own cost, charged to the agency that owns the widget


Understanding Credit Consumption

Visibility Reports

Standard platforms (ChatGPT, Perplexity, AI Mode, Claude): any mix costs 1 credit per prompt total.

Premium platforms (ChatGPT 5, Claude Search, Gemini, Grok): each one adds +1 credit per prompt.

Scheduled reports use the same rules: credits per run = prompts x credits per prompt, where credits per prompt = 1 if you selected any standard platform, plus 1 for each premium platform selected (if you select only premium engines with no standard, you pay one credit per premium platform per prompt, with no "free" standard bundle).

See Understanding Credits for examples.

Lead Widget Reports

A lead report follows the same arithmetic: prompts x credits per prompt, with the prompt count and the engines coming from your widget settings. The brand research behind it is included in the same reservation, so what the Widget tab shows as the price of a lead is the whole cost.

The agency that owns the widget pays, always. The visitor never sees a price and never spends anything. Beside the price, the tab shows what your leads actually cost this month, read from this ledger rather than from the settings.

Content Generation

10 credits per article includes:

  • Full article generation

  • AI-generated images

  • SEO metadata

SEO Audits

Audit Type

Credits

Technical SEO

Free

Lighthouse

1 credit

Competitor

1 credit each

Outreach Credits

Action

Credits

Categorize citations

1 credit per 10 URLs

Discover contacts

1 credit per 3 URLs

Generate AI email

1 credit

Verify backlink

1 credit

Send email

Free

Google Business Profile Credits

Action

Credits

GBP AI content generation

1 credit

Geo-grid scan

1 per 9-point block: 3x3 = 1 credit, 5x5 = 3 credits, 7x7 = 6 credits

Geo-grid cost formula: ceil(point_count / 9). A 3x3 grid has 9 points (1 credit), a 5x5 grid has 25 points (3 credits), a 7x7 grid has 49 points (6 credits).

E-commerce / Product SEO Credits

Action

Credits

Product SEO scan

3 credits

Product description generation

2 credits

Product alt text generation

3 credits

Store readiness audit

5 credits

AI Commerce recommendations

3 credits

Schema audit

2 credits


Credit Deduction Order

When you use credits, they're deducted in this order:

  1. Monthly Credits (used first)

  2. Top-Up Credits (used when monthly depleted)

This ensures you get maximum value from your subscription before touching purchased credits.


Low Credit Warnings

In-App Notifications

Rank Prompt warns you when credits are low:

  • Warning when below 20% of monthly allocation

  • Alert when credits run out

  • Notification for failed actions due to insufficient credits

Email Notifications

Enable email alerts in Settings → Notifications:

  • "Insufficient Credits" email option

  • Get notified when actions fail


What Happens When Credits Run Out?

Visibility Reports

  • Cannot run new reports

  • Scheduled reports skip (no charges)

  • Existing reports remain accessible

Content Generation

  • Cannot generate new articles

  • Can still edit existing articles

  • Can still publish to connected blogs

SEO Audits

  • Cannot run new Lighthouse audits

  • Technical audits still work (free)

  • History remains accessible

Solution

When credits run out:

  1. Wait for monthly reset (next billing cycle)

  2. Top up with additional credit packs

  3. Upgrade to a higher plan for more monthly credits


Top-Up Credits

Purchasing Top-Ups

  1. Go to Plans & Billing → Top-Ups tab

  2. Select a credit pack

  3. Complete payment

  4. Credits added immediately

Available Packs

Pack

Credits

Price

Small

50

$18

Medium

100

$35

Large

200

$65

Why Top-Up?

  • Heavy usage months

  • Special projects or launches

  • Don't want to upgrade permanently

  • Credits never expire


Frequently Asked Questions

Do monthly credits roll over?

No. Monthly credits reset each billing cycle. Unused credits are lost.

Do top-up credits expire?

No. Top-up credits never expire and remain available indefinitely.

Which credits are used first?

Monthly credits are always used before top-up credits.

Can I see what used my credits?

Yes. The Credit Log shows every credit-consuming action with dates and amounts.

Why did my action fail?

If you see "Insufficient Credits," you've run out. Top up or wait for monthly reset.

What is AI Budget and is it the same as regular credits?

No. AI Budget is a separate balance that powers AI features (the agent copilot, inline content editing, and AI image generation), while regular credits cover reports, articles, audits, and outreach. They are separate pools, but you fund AI Budget by converting report credits, and that converted budget is cycle-expiring. Alternatively, connect your own OpenAI key (BYOK) in Agent Settings to use your own account for agent conversations.


Best Practices

Monitor Regularly

Check your credit balance weekly to avoid surprises, especially if you have scheduled reports running.

Plan Ahead

If you have a big project coming (multiple reports, content campaign), ensure you have enough credits.

Use Free Features

Take advantage of features that don't use credits:

  • Technical SEO audits (free)

  • Dashboard viewing

  • Analytics (after connection)

  • Settings and preferences


Next Steps

  • Plans & Subscription - Upgrade for more credits

  • Understanding Credits - Learn more about credits


Need Help?

If you have questions about credit usage, contact us at [email protected].

Did this answer your question?
😞
😐
😁