How to get your LeadMagic API usage, balance and spend programmatically

What the LeadMagic API exposes

Call it yourself

Credential. A normal LeadMagic API key.

curl https://api.leadmagic.io/v1/credits \
  -H "X-API-Key: $LEADMAGIC_API_KEY"

{ "credits": 4825.5 }

Gotchas

• The balance can be fractional.
• Failed matches are never charged, so call volume overstates spend.
• Unused credits roll over for up to two months on Essential and above.

How LeadMagic charges

Monthly credit pool across 15+ endpoints; failed matches never charged. Rollover up to 2 months on Essential+.

Free allowance. 100 on signup. 100 credits on signup.

At zero. 429. Failed matches never charged; presumed block on exhaustion.

• 300 requests per minute, per key. 100/min for Profile/Company/Jobs.

Or let Argus track it

Paste the key once. Argus keeps the ledger, and your coding agent reads it through the MCP server.

• Reads the LeadMagic balance every hour and keeps the series, so you get burn per day (top-ups never count as negative spend) and days until it hits zero.
• With the SDK, reads the credit headers on every response, so the balance moves per call instead of per poll.
• Emails you on low balance, days to zero, a spend spike, or projected overage.
• Hands all of it to your coding agent over MCP, so it can ask what a run cost or how much runway is left without leaving the editor.

> what has leadmagic cost today, and how long until it runs out?

get_overview       → leadmagic: mtd spend, burn per day, days to zero
get_request_costs  { "provider": "leadmagic", "limit": 25 }
get_advisories     → credits_low, spend_spike, rate_limit_low …

Questions

Does LeadMagic have an API for its balance?

Yes. GET https://api.leadmagic.io/v1/credits with your key in X-API-Key returns { credits }, free of charge. Every API response also carries X-Credits-Remaining and X-Credits-Cost headers.

Can I get LeadMagic spend per day from the API?

Not as a series. Derive it from how much the balance drops each day, ignoring top-ups.

What happens when LeadMagic credits run out?

Requests fail with HTTP 429. Failed matches never charged; presumed block on exhaustion.

What key does Argus need for LeadMagic?

A normal LeadMagic API key.

Related

Apollo.ioHunter.ioPeople Data LabsProspeo