Credits and limits

What every action costs, when credits are refunded, how to quote a call with dry_run, and the request and size limits.

Credits are the hard limit on spend. Every action that costs credits is quoted before it runs, a job that does not fit the balance is refused with 402 insufficient_credits and nothing is charged, and credits charged for work that could not run are refunded. The request and size limits below only stop one key from flooding the system.

The balance is credits.remaining in GET /workspace (MCP: get_workspace). The first workspace you create with create_workspace starts with 250 credits; every later one starts at 0. Plans add a monthly allowance:

PlanCredits per monthTrial credits
Starter5,0001,000
Growth8,0002,000
Agency22,000None; starts on a call

More on pricing, including top-ups.

What each action costs

ActionAPI or toolCreditsRefunded whendry_run
Page for a new leadPOST /jobs, generate_assets3 (1 analysis + 2 page), the cost_per_asset ceiling, plus any research columns the campaign runs on new leadsThe page cannot start (before the answer), the lead fails later, or the job was accepted but never startedYes
Page for a lead whose profile was already readPOST /jobs, generate_assets2The page cannot start (before the answer), the lead fails later, or the job was accepted but never startedYes
Page that already exists in the campaign (reused: true)POST /jobs, generate_assets0Nothing was chargedYes
Lead analysis on importimport_leads1 per new lead whose profile was not read beforeThe analysis cannot startYes
Lead analysis on an Instantly importimport_from_instantlyUp to 1 per new lead analysed, at most limit leads; nothing for a campaign that is not active or needs no LinkedIn URL-Yes
Page generation for a campaigngenerate_pages2 per pageThe run cannot startYes
Messages (emails and LinkedIn)generate_messages0.5 per lead, whatever the channelsThe run cannot startYes
Research columnrun_researchPer lead and column; the price is credits_per_lead on each column in list_columnsA column that finds nothingYes

A dash in "Refunded when" means no refund is documented for that action. A refunded page shows in refunded, credits_refunded and refund_message on GET /jobs/{id}.

Free: every read (list_*, get_*, check_variables), and every write to a brand, template, media, campaign, column, cell, message setting, Instantly send or event subscription (create_campaign takes dry_run too, and spends nothing). set_cell_values and set_messages are free.

In the app. These are charged by the NeuroPage app, not by the API or MCP: a test send of a sequence email costs 1 credit, and a lead's mobile number costs 20 credits, charged only when a number is found and only if you turned on phone lookup in the Telegram integration.

Limits

LimitValueErrorSandbox key
Requests per key, or per signed-in user60 per minute429, limit: requests10 per minute
Leads per job (POST /jobs, generate_assets)25422 too_many_leads25
Running page jobs per workspace2429, limit: running_jobs1
New pages per workspace per hour200429, limit: assets_hour10 (the day cap)
New pages per workspace per day1,000429, limit: assets_day10
Leads per import_leads call500422 validation_failed500
create_workspace per user per day3429, limit: workspaces_dayNot available
Credits per key per monthThe key's monthly cap, if you set one; resets on the 1st (UTC)402 spend_cap_reached30

Every 429 has a Retry-After header, and responses carry RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. A job that only reuses existing pages starts nothing and counts against none of the page limits. A sandbox key is for trying the API on a shared demo workspace. Contact us for sandbox access; see Sandbox and plans.

Worked example: 25 new leads, pages and messages

A new lead costs 1 analysis plus 2 page credits, which is the 3 in cost_per_asset. This campaign has no research columns.

StepCalculationCredits
Pages for 25 new leads25 × (1 + 2)75
Messages for 25 leads25 × 0.512.5
Total87.5

Send the same 25 LinkedIn URLs to the same campaign again and every page comes back reused: true for 0 credits. If the profiles were already read in another campaign, the pages cost only the 2 page credits each: 50 in all. Regenerating messages charges 0.5 credits a lead again.

Quote first

Add dry_run: true to POST /jobs, or to any spending tool over MCP (generate_assets, import_leads, import_from_instantly, generate_pages, generate_messages, run_research). It answers with the most the call can cost and your balance, and changes nothing. For POST /jobs the answer is a JobQuote: credits_quoted, leads_accepted, leads_reused, leads_rejected, credits_remaining and enough_credits.

bash
curl -X POST https://neuropage.io/api/v1/jobs \
  -H "Authorization: Bearer np_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "landing_page", "dry_run": true, "leads": [{ "linkedin_url": "https://www.linkedin.com/in/jane-doe" }]}'

If the balance is too low, a real call returns 402 insufficient_credits and nothing is charged; 402 spend_cap_reached means the key's monthly cap would be passed. See Errors and Concepts, and the MCP tools for the same table per tool.