Docs · Credits, plans and billing

Credits, plans and billing

How credits work#

A credit is the unit of everything. A page costs what it took to read: the ladder starts cheap and climbs only when a site refuses, and you pay for the rung that produced what you got. You never choose the engine; you set a ceiling (the tier) and, if you want, a cap per page.

Reading a page#

ModeWhat happensCredits
FetchA plain HTTP request with a real browser's fingerprint1
Fetch with sessionThe same request carrying cookies a browser earned on this site earlier. One render earns the session; every page after it is read this way2
RenderA real Chrome loads the page, runs its JavaScript, waits for it to settle4
Render, residentialThe same Chrome from a residential address; 1 MB of traffic included16, +4 per further started MB
Render, solvedA render plus a paid answer for a captcha widget on a form your steps submit. A widget passed on a click is a render22
UnlockedA rented fetch through a specialist service; the last rung, stealth only40

Add-ons and the other things#

Credits
A screenshot+1
A PDF documentat least 2 (a fetched one 2, a rendered one 4)
Structured extraction with a model on your own key1 per 1,000 tokens in and out (the model bill is yours)
A map (POST /map, or Discover on the Sources screen)1 per sitemap file read, at the rung that read it — most sites 1; never per URL declared
A render bought on suspicion that found a short page unchangedthe http rung's price; the render is on the ledger at 0

Web search and the agent#

A search and an agent run are priced the way pages are: by what they read.

Credits
A web search (POST /search): the results pages whose results it gives, at most 4 together whatever rung read them — a render, or Google's page through the residential exit. Each search is charged on its own, an agent's included4 (1 when DuckDuckGo or Bing answers alone)
Each further page of results (page 2–10)its own results page, priced the same
The same search again within the hour (ten minutes for news) — same query, country, language, freshness and sites0, answered from the last one
A results page every engine refused0
Each result's page, when the search asks to scrape themwhat that page took to read, as any page
An agent run (POST /agent): the pages it readswhat each took to read; a refused page is free
The agent's model tokens, on MeshArc's modelthe model provider's price + 20%, in credits (Billing shows the rate per million tokens)
The agent's model tokens, on your own model connection (connectionId)1 per 1,000 tokens; your provider bills the tokens to your key
A page a conversation already read, read again in a follow-up or a continued run0
The agent over a table (POST /agent/batch)each row as one agent run, up to maxCreditsPerRow; the table never spends more than rows × that cap
Checking a table first (POST /agent/batch/preview) and its estimate0
A monitor's run (a search or a question on a schedule)what that search or agent run costs; a daily Google search is about 120 a month

An agent run stops at its maxCredits (2,000 unless you set another) with what it found, and Continue carries on with a new budget. A monitor can have a monthly cap (budget.perMonth) and an agent monitor a cap per run (budget.perRun); GET /estimate says about what a month costs before you save one.

Free, always#

  • A page the site refused, whatever the ladder spent finding out — you pay for pages, not for walls.
  • A 404 or 410, and a 200 that is the site's not-found page.
  • A page served from the cache (cache_max_age_hours), an incremental copy carried forward when the sitemap says it did not change, a URL robots.txt kept us from.
  • The discovery a run makes for itself, the change record, webhooks, exports, destinations.
  • A document the project did not ask for (recorded as seen).
  • A search results page every engine refused, and the same search again within the hour (ten minutes for news).
  • Checking an agent table before it runs, and a page an agent conversation already read, read again.

Tiers#

The ceiling you set per project: http = Fetch and Fetch with session (every plan) · browser = + Render (Free, Starter and up) · stealth = + residential, solved, Unlocked (Growth and up; on Free, a trial: 200 credits spent on these rungs over the workspace's life, every attempt counted, whether the site answered or not — after that it stops at browser, and a page that needed more is recorded TIER_LIMIT) · auto = as high as your plan allows (a project made with New project starts here). A page still starts where the site is known to answer (the cheapest engine, on a site not read before) and climbs only when refused. The plan caps the tier on a project's runs, a scrape, the playground and a map alike. A page that needs more than the tier allows is recorded TIER_LIMIT at 0 — "this costs more than you allow", not "unreadable". max_credits_per_page (maxCredits on /scrape) is a finer cap. A project also takes max_credits_per_run and max_credits_per_month, and a monitor a budget (perRun, perMonth): a run stops at the first, and a scheduled run due once the month's is spent is skipped. GET /estimate says about what a schedule costs a month before you save it.

In practice#

Credits
A 200-page documentation site, plain fetch, read twice400
The same site, rendered (JavaScript-only), read twice1,600
A 100-page Cloudflare-protected site: one render earns the session, 99 pages read with it4 + 198 = 202
A residential render of a 0.6 MB page / a 2.3 MB page16 / 24
A map of gov.uk (508,000 URLs in 29 files)29
100 pages extracted to JSON with your own model key, ~3,000 tokens each300
A 100-page project on the weekly schedule, plain, for a month~400

Plans#

Every workspace starts on the Free plan — 1,000 credits, once, no card. Move to a paid plan from Billing whenever you need more room; what you have built carries over.

FreeStarterGrowthScaleEnterprise
Price$0$29 / mo$99 / mo$349 / mofrom $1,500 / mo
Credits1,000, once100,000 / mo500,000 / mo2,500,000 / mono ceiling
Tierbrowserbrowserstealthstealthstealth
Projects21050250∞
Pages per run5005,00050,000200,000∞
Crawls at once1 (2 interactive)2 (4)5 (10)15 (30)custom
Agent runs at once11310custom
Rows in one agent table252005001,000custom
Sub-accounts———25custom
Requests per minute60120300600custom
Past the allowancestopsbuy credits $5 = 15,000overage at $0.30 / 1k up to a cap you set; buy credits $5 = 15,000; priority support, DPAoverage at $0.20 / 1k up to a cap you set; buy credits $5 = 25,000; one-month rollover; invoicingdedicated workers and exits, static IPs, a person to call
In INR, + 18% GST₹0₹2,499 / mo₹8,499 / mo₹29,999 / moagreed

Annual: twelve months for the price of ten; credits still arrive monthly. The free tier is a trial, not a hobby plan: the credits do not renew, nothing to buy. The workspace's owners and admins are emailed when 80% of the free credits are spent and when they are used up, once each, as it happens (again after an operator grants more); a workspace that ran out long before is not emailed when it next tries. The free plan's stealth trial is told the same way, at 80% and when it is used up.

Beyond the allowance#

Three layers, drawn in this order:

  1. The allowance — what the plan includes, per calendar month. A month a subscription starts or changes plan in gets a blended number: each day at the plan it was on — the old plan's share of the days gone plus the new plan's share of the days left — so a day-28 upgrade is not a full month's credits for three days' money, and a second change the same month builds on the first. What was spent stays spent; the ceiling moves. A subscription that resumes after a halt gets the month's number back: the cycle was paid in full.
  2. Overage (Growth and Scale) — work continues past the allowance at the plan's per-thousand rate, billed as a line on the next renewal invoice, up to a cap you set on Billing: twice the allowance by default, any multiple, or none. Past the cap, runs stop.
  3. Bought credits (every paid plan) — packs of $5 (₹449 + GST), 15,000 credits on Starter and Growth, 25,000 on Scale. Drawn only after the allowance and the overage cap, never expiring, kept across a plan change and across a cancellation -- the free plan draws on its own allowance, so bought credits wait there until the workspace is on a paid plan again. Bought from Billing; credited the moment the payment is confirmed.

Scale also carries a month's unused allowance into the next month, once.

A limit agreed for your workspace — on a call, in a contract — is set on the workspace itself and always wins over the plan's number, so a change to what a plan includes never takes away something you were promised. Settings → Limits shows what applies to you.

How a run is metered#

  • At the enqueue, a workspace with nothing left is told so — 402 plan_limit with a plain reason — before a job exists.
  • At the claim, the run is given the budget it may spend, so a crawl cannot outrun the balance mid-run. A scrape and a playground fetch get one too, while credits are enforced.
  • Per page, what is left bounds the climb: an engine dearer than the balance is not tried, and a page it alone could read is recorded BUDGET_EXHAUSTED at 0. A page that needs more than is left (a render with 3 credits to go) is not fetched; the run stops there.
  • Per page, the run's tally; a crawl that reaches its budget stops with StopReason: credits and keeps what it read.
  • The ledger (the Billing screen): one row per one-off (a scrape, a map, a model pass), one row per engine per crawl (upserted as the run goes — with a note when renders were billed at the rung below), and free lines for the things worth showing at zero. Every page row carries the engine that read it, so a bill can be taken apart to the URL.
  • The meter on the Billing screen is what the ledger adds up to this month; on the free tier, over the workspace's whole life.

Payments#

Payments go through Razorpay, and Billing does the rest:

  • Choose a plan — monthly or yearly, in USD or INR. INR prices are before GST; 18% is added at checkout. USD is the export list, for a customer outside India, with no GST; a workspace whose invoice details name a GSTIN or an Indian state is offered INR only, since a supply to it carries GST whatever the currency. Checkout is Razorpay's: MeshArc never sees your card. The plan is yours the moment Checkout confirms the payment; Razorpay's webhook says the same thing again a moment later.
  • Tax invoices — every payment gets a numbered tax invoice (MA/2026-27/0001, one series per financial year) from Discover Webtech Private Limited, GSTIN 23AAFCD0880K1ZP, Indore: taxable value and, for a customer in Madhya Pradesh, CGST 9% + SGST 9%; for the rest of India, IGST 18%; for a customer paying in USD, zero-rated as an export of services under LUT. Give your legal name, GSTIN (or your state, if unregistered) and address under Invoice details on Billing and they appear on every invoice from the next payment. Open it from Payments → tax invoice; the browser's Print saves the PDF. Razorpay's own receipt is linked beside it.
  • Credit notes — a refund against an invoice (the unused days of a mandate replaced on an upgrade, or a refund made by support) gets a numbered credit note (MA-CN/2026-27/0001) that names the invoice and reverses the refunded amount's share of its tax. It sits under the payment on Billing → Payments.
  • Change plan — an upgrade is applied at once and a downgrade when the cycle ends; the month's credits are blended by the day either way. How depends on what holds the mandate. Where Razorpay can move the subscription itself — a card issued outside India, a bank mandate (eNACH) — it prorates by the day and charges the difference for the rest of the cycle; a downgrade shows as Growth until 14 Oct, then Starter with a Keep Growth button. Where it cannot — UPI, or a card issued in India, whose mandate is fixed when it is registered — the change is a new mandate you authorise in Checkout: an upgrade starts now and the unused days of the old mandate are refunded to the account that paid (5–7 working days, with a credit note); a downgrade's new mandate starts when the current one ends and cannot be called off. Changing the currency means cancelling at the cycle end and starting again.
  • Paid by UPI? A UPI mandate cannot be moved to another plan, so a change is a new mandate to authorise through Checkout: an upgrade starts now and the unused days of the old mandate are refunded pro rata; a downgrade starts when the current mandate ends, and cannot be called off. Update card does not apply to a mandate — to pay another way, change the plan and authorise the new subscription with a card.
  • Update card — Checkout again, on the existing subscription.
  • Cancel at cycle end — the plan stays until the period ends, then the workspace is on the free plan with its projects and data kept.
  • A failed renewal — Razorpay retries on three consecutive days; the plan stays meanwhile and Billing says so. If every retry fails the subscription is halted: the workspace is on the free plan and runs stop until the payment goes through — Update card, approve the request in your UPI app, or the link in Razorpay's email. Your projects, pages and history are kept; nothing is deleted for non-payment. The workspace's owners and admins are emailed by MeshArc on the day the payment fails, on the day it is halted, and a week and a month later; then no more.
  • Renewals above ₹15,000 — the RBI's ceiling for a recurring payment taken without you (Scale monthly, and every yearly plan in INR). A card cannot hold a mandate that size. Pay by bank mandate (eNACH, offered in Checkout) and renewals are automatic; pay by UPI and your UPI app asks you to approve each renewal — MeshArc emails you three days before. If a renewal is not approved it is a failed renewal, as above.
  • Buy credits and the overage cap — see Beyond the allowance above.
  • Payments — every charge with its Razorpay invoice, on Billing.

For the API: GET /me/billing carries the catalogue, the subscription, the bought-credit balance and the receipts; POST /me/billing/subscribe, /confirm, /change, /keep, /cancel, /card, /credits/buy and PATCH /me/billing/cap are what the buttons call. They need an admin session with a fresh second factor; an API key cannot buy.