API review

LeadMagic API review

Pay-per-valid-result B2B enrichment API: work email finder, catch-all-resolving validation, mobiles, company/job/ads data and people/company search, with a hosted OAuth MCP and CLI. Best for cheap email validation.

Verified 25 Oct 2026 · 27 endpoints listed · Official MCP server

See pricing

LeadMagic API docs

What a call costs

The actions you pay for, as LeadMagic prices them in credits.

Action	Cost	Per
Email Finder	1 credit	per valid email
Email Validation	0.25 credits	per valid/invalid result (unknown free)
Mobile Finder	5 credits	per valid mobile
Company Search	1 credit	per company
Profile Search	1 credit	per profile
B2B Social (profile) to Email	5 credits	per email
Employee Finder	0.05 credits	per employee
Job Change Detector	3 credits	per request

Show all 20 priced actionsHide the rest

Action	Cost	Per
Personal Email Finder	2 credits	per email
Email to B2B Profile	10 credits	per profile
Jobs Finder	1 credit	per job
Role Finder	2 credits	per role
Company Funding	4 credits	per company
Technographics	1 credit	per company
Competitors Search / Company Lookalike	5 credits	per successful response
Google / Meta Ads Search	1 credit	per ad returned
B2B Ads Search	1 base + 1 per ad	per search (max 50 ads)
B2B Ad Details	2 credits	per ad
People / Company / Job Search API	1 credit (Essential, Growth); 0 (Professional, Ultimate)	per returned record
Local Leads (bulk)	200 credits	per keyword x location search, charged at submission

Pricing, plan by plan

US dollars, as LeadMagic's pricing page shows them on 25 Oct 2026. Monthly and annual billing are shown apart.

Free tier None. No free trial or free-credit program; a paid plan is chosen at signup.

Essential

$99/mo

billed monthly

$83/mo

billed annually

5,000 credits/mo (60,000/yr on annual); $0.0198/credit monthly, $0.0165 annual; 10k search exports/day; 1 table seat

API included

Plan details

Top-ups or auto top-up; wallet capped at 2x monthly allotment

Growth

$249/mo

billed monthly

$208/mo

billed annually

20,000 credits/mo (240,000/yr); $0.0124/credit monthly, $0.0104 annual; 25k exports/day

API included

Plan details

Top-ups or auto top-up

Professional

$499/mo

billed monthly

$416/mo

billed annually

50,000 credits/mo (600,000/yr); $0.0100/credit monthly, $0.0083 annual; unmetered search API 5 RPS; 50k exports/day; 2 table seats

API included

Plan details

Top-ups or auto top-up

Ultimate

$849/mo

billed monthly

$708/mo

billed annually

100,000 credits/mo (1.2M/yr); $0.0085/credit monthly, $0.0071 annual; unmetered search API 10 RPS; 100k exports/day; 3 table seats

API included

Plan details

Top-ups or auto top-up

Enterprise/team access

Custom quote

By request on plans $499+; every workspace user needs a paid seat at $49 per seat per month.

API included

Plan details

Enterprise Security: annual only, from $10,000.

Rate limits

Per-endpoint per-minute limits: Email Finder and Email Validation 600 req/min (~10 req/s burst, ~50 in flight); most other endpoints 300 req/min; Company Search v1, Profile Search, Jobs Finder and metered Company Search v3 100 req/min.

Limit	Essential/Growth	Professional	Ultimate
Search Api	1 credit per result, metered	unmetered, 5 RPS, up to 13,333/day	unmetered, 10 RPS, up to 13,333/day

How to get an API key

LeadMagic uses API key. The steps below follow LeadMagic's own docs.

Create a LeadMagic account. API access starts on the Essential plan.
app.leadmagic.io account settings, API keys page (issued immediately after choosing a paid plan)
Send it with every request: header X-API-Key (key starts with lm_; header name case-insensitive). Hosted MCP and CLI use OAuth instead.

Make a first call: Work email from name + company. Keep the key in an environment variable, never in the command.

curl -X POST "https://api.leadmagic.io/v1/people/email-finder" \
  -H "X-API-Key: $LEADMAGIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Where the docs live

What	Where
Documentation	leadmagic.io/docs/v1/introduction
API reference	leadmagic.io/docs/api-reference
OpenAPI spec	leadmagic.io/openapi.json
llms.txt	leadmagic.io/docs/llms.txt
Changelog	leadmagic.io/docs/changelog
Base URL	`https://api.leadmagic.io`
MCP server	`https://mcp.leadmagic.io/mcp`
SDKs	lm-tui CLI (lm command, browser OAuth), OpenAPI 3 spec

Strengths and limits

Where it fits

Cheap email validation (0.25 credits per definitive result, unknown is free)
Email finder early in a waterfall where its find rate stays high
Mobile numbers at 5 credits per hit
Async bulk enrichment of large lists (up to 500,000 rows per job) with progress streaming
Unmetered people/company/job search on Professional and Ultimate plans
Agent workflows through a hosted MCP with 100+ tools and free cost preview

Where it falls short

Last-resort slot in a waterfall: terms let LeadMagic throttle or suspend accounts whose sustained find rate drops below 10%
Reselling or embedding data in a product (self-serve plans are internal use only)
Buyers who need SOC 2 or ISO 27001 (LeadMagic states it holds neither)
Free testing: there is no free trial; a paid plan is required at signup

Worth knowing

Fair-use clause: if sustained find rate falls below 10% (explicitly including use late in a waterfall or on exhausted lists), LeadMagic may throttle, suspend, change credit consumption or require a custom contract, regardless of prepaid credits.
Hosted MCP is OAuth only; static API keys in MCP config headers are not supported on production.
Annual and custom deals do not roll over credits. Monthly plans cap the total wallet (subscription + top-ups) at 2x the monthly allotment; excess follows expiry dates, and a downgrade recalculates the cap immediately.
Self-serve plans are internal use only: no resale, embedding or showing results to your clients.
Search endpoints never return emails or phones; legacy contact-detail flags return 400. Pay separately via Email Finder / Mobile Finder.

5 moreShow fewer

Validation bills instant 'invalid' results (syntax, no-MX, disposable, blocklisted) at 0.25; only 'unknown' is free.
402 org_closed means the subscription ended; buying credits or rotating keys does not fix it, and repeated retries pause the key with 429 for up to 24 h.
Past-due payment freezes the account immediately (API, CLI, MCP and dashboard).
MCP tool credit tables differ from REST in places (e.g. b2b_profile_to_work_email listed at 1 credit vs REST profile-to-email at 5; find_company_employees 1/person vs REST employee-finder 0.05). Check preview_cost.
Team access beyond the included table seats requires a $499+ plan and $49 per seat per month.

Our take

LeadMagic's email finder comes right after Hunter in the email chain of an enrichment service we built for a B2B data company, and the service also calls its mobile finder.

Who should use it

Use LeadMagic for: Cheap email validation (0.25 credits per definitive result, unknown is free)
Look elsewhere for: Last-resort slot in a waterfall: terms let LeadMagic throttle or suspend accounts whose sustained find rate drops below 10%

If LeadMagic is not the answer

Other Enrichment tools in this directory, each with its own review.

BetterContact

Enrichment

From $15/mo

Best for one-bill access to 20+ email/phone providers without holding their keys.

BetterContact API review

BuiltWith

Enrichment

From $245.83/moOfficial MCP

Best for front-end / web technographics per domain with first/last detected dates.

BuiltWith API review

Clearbit

Enrichment

Best for existing Clearbit API customers maintaining legacy integrations.

Clearbit API review

Before you build

Four things to settle first, each read off LeadMagic's own pages.

Confirm the API is on your planAPI access starts on the Essential plan. Free tier: None. No free trial or free-credit program.
Keep the key out of your codeAPI key. It is sent as: header X-API-Key (key starts with lm_; header name case-insensitive). Hosted MCP and CLI use OAuth instead..
Design around the rate limitPer-endpoint per-minute limits: Email Finder and Email Validation 600 req/min (~10 req/s burst, ~50 in flight); most other endpoints 300 req/min; Company Search v1, Profile Search, Jobs Finder and metered Company Search v3 100 req/min.
Know the catch before you scaleFair-use clause: if sustained find rate falls below 10% (explicitly including use late in a waterfall or on exhausted lists), LeadMagic may throttle, suspend, change credit consumption or require a custom contract, regardless of prepaid credits.

Want us to build it for you?

Tell us what you want LeadMagic to do in your stack. We will show you how we would wire it into your data, outbound or CRM, and what we would check first.

Book a call

See case studies

Read from leadmagic.io/pricing, leadmagic.io/docs/api-reference and leadmagic.io/help/api-usage/api-rate-limits. Verified 25 Oct 2026.

All 27 endpointsFor developers: method, path, what it does and what it costs.

Base URL: api.leadmagic.io

Bulk and async: Yes: /bulk jobs up to 500,000 rows per job, pause/resume/restart/priority, SSE progress stream, CSV download; billed per successful row at single-call rates.

Webhooks: Yes, for async jobs: configure in Settings > Webhooks (HTTPS), events job.completed / job.failed, signed with a signing secret; batch API also supports per-client webhooks.

Filter endpoints

27 endpoints

Method	Path	What it does	Cost
POST	`/v1/people/email-finder`	Work email from name + company	1 credit per valid email; not found is free
POST	`/v1/people/email-validation`	Validate deliverability (incl. catch-all resolution)	0.25 credits for valid or invalid; unknown is free
POST	`/v1/people/mobile-finder`	Direct mobile number	5 credits per valid mobile; free if none
POST	`/v1/people/personal-email-finder`	Personal email from a B2B profile	2 credits per email found
POST	`/v1/people/b2b-profile-email`	B2B profile URL to work email	5 credits per email found; free if none
POST	`/v1/people/profile-search`	Full B2B person profile from profile URL	1 credit per profile
POST	`/v1/people/b2b-profile`	Email address to B2B person profile	10 credits per profile
POST	`/v1/people/job-change-detector`	Has the person changed jobs	3 credits per request (billed per check)
POST	`/v1/people/role-finder`	Who holds a role/title at a company	2 credits per match; miss is free
POST	`/v1/people/employee-finder`	List employees at a company	0.05 credits per employee (20 per credit); free if none
POST	`/v3/people/search`	Filtered people search (company + people filters)	1 credit per returned person on Essential/Growth; unmetered on Professional (5 RPS) and Ultimate (10 RPS) up to 13,333 searches/day
POST	`/v1/companies/company-search`	Company enrichment by domain/name/profile	1 credit per company
POST	`/v3/companies/search`	Filtered company search	1 credit per company returned on metered plans; unmetered on Professional/Ultimate within fair use
POST	`/v3/companies/lookalike`	Lookalike companies from a seed domain or description (aliases /v3/companies/competitors, competitors-search)	5 credits flat per successful response; free if none or degraded; not covered by unmetered search
POST	`/v1/companies/company-funding`	Company profile + funding history	4 credits per company (charged even with no rounds; free if company not found)
POST	`/v1/companies/competitors-search`	Competitor list	5 credits
POST	`/v1/companies/technographics`	Tech stack for a company	1 credit per company
POST	`/v1/jobs/jobs-finder`	Open job postings	1 credit per job
POST	`/v3/jobs/search (+ /v3/jobs/search/export, /v3/search/stats)`	Job posting search, export and stats	Search: 1 credit per returned job on metered plans; unmetered on Professional/Ultimate
GET	`/v3/jobs/search/{companies,tags,titles,locations,roles,catalogs,occupation-taxonomy,stats}, /v1/jobs/{countries,regions,job-types,company-types,industries}`	Filter helper / taxonomy lookups for job search	Not stated
POST	`/v1/ads/google-ads-search, /v1/ads/meta-ads-search`	Ads a company runs on Google / Meta	1 credit per ad returned; free if none
POST	`/v1/ads/b2b-ads-search, /v1/ads/b2b-ads-details`	B2B (LinkedIn-style) ad search and ad detail	Search: 1 base + 1 per ad (up to 50 ads); details: 2 credits
POSTasync	`/bulk/submit (+ /bulk/validate, /bulk/jobs, /bulk/jobs/{id}, /results, /download, /errors, /events, /stream, /pause, /resume, /restart, /priority, /review)`	Async bulk enrichment jobs up to 500,000 rows, with progress stream and CSV download	Same rate as the matching single endpoint, per successful row; failed rows free; free to submit
POSTasync	`/bulk/local-leads`	Local business leads search as a bulk job	200 credits per unique keyword x location search, charged up front at submission (not per row); duplicates charged once; dryRun free; job over shared daily capacity returns 429 local_leads_capacity uncharged
POSTasync	`/v1/batch (+ GET /v1/batch, /v1/batch/{id}, preview-cost, budgets, suppression-lists, clients, client webhooks, providers)`	Mixed-product batches with cost preview, credit budgets, suppression lists and per-client webhooks (agency features)	Preview cost is free; rows billed at product rates
GET	`/v1/credits`	Check credit balance	Free
GET	`/v1/analytics/{dashboard,usage,products,credits,summary,daily,day/{date}}`	Usage and credit analytics, rate-limit state	Free