{"openapi":"3.1.0","info":{"title":"LeadMagic API","description":"Pay-per-call access to the LeadMagic B2B data enrichment API — email finding & validation, mobile numbers, profile/company enrichment, employee & role discovery, job postings, and ads intelligence. No accounts, no subscriptions — pay per request with x402 or MPP.","version":"1.0.0","x-guidance":"All inputs go in the POST body. POST /api/email-finder { first_name, last_name, domain } finds a work email. POST /api/email-validate { email } checks deliverability. POST /api/profile-search { profile_url } enriches a B2B profile. POST /api/company-search { company_domain } enriches a company. POST /api/mobile-finder { work_email | profile_url } finds mobile numbers. GET /api/health is unprotected. See /openapi.json for full request/response schemas.","guidance":"All inputs go in the POST body. POST /api/email-finder { first_name, last_name, domain } finds a work email. POST /api/email-validate { email } checks deliverability. POST /api/profile-search { profile_url } enriches a B2B profile. POST /api/company-search { company_domain } enriches a company. POST /api/mobile-finder { work_email | profile_url } finds mobile numbers. GET /api/health is unprotected. See /openapi.json for full request/response schemas."},"servers":[{"url":"https://stable-leadmagic.dev"}],"tags":[{"name":"B2b Ad Details"},{"name":"B2b Ads Search"},{"name":"B2b Profile"},{"name":"B2b Social Email"},{"name":"Company Funding"},{"name":"Company Search"},{"name":"Email Finder"},{"name":"Email Validate"},{"name":"Employee Finder"},{"name":"Google Ads Search"},{"name":"Health"},{"name":"Job Countries"},{"name":"Job Types"},{"name":"Jobs Finder"},{"name":"Meta Ads Search"},{"name":"Mobile Finder"},{"name":"Personal Email Finder"},{"name":"Profile Search"},{"name":"Role Finder"}],"paths":{"/api/health":{"get":{"operationId":"health","summary":"health","tags":["Health"],"security":[],"responses":{"200":{"description":"Successful response"}}}},"/api/b2b-ad-details":{"post":{"operationId":"b2b-ad-details","summary":"LeadMagic B2B Ad Details — full details for a specific B2B ad by `ad_id` from /api/b2b-ads-search.","tags":["B2b Ad Details"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.06"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_id":{"type":"string","minLength":1,"description":"B2B ad ID, as returned by /api/b2b-ads-search."}},"required":["ad_id"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/b2b-ads-search":{"post":{"operationId":"b2b-ads-search","summary":"LeadMagic B2B Ads Search — find B2B (LinkedIn) ads a company is running, from its domain or name.","tags":["B2b Ads Search"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_domain":{"description":"The company's domain.","type":"string"},"company_name":{"description":"The company's name.","type":"string"}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/b2b-profile":{"post":{"operationId":"b2b-profile","summary":"LeadMagic Email to B2B Profile — resolve a work email address to its B2B profile URL.","tags":["B2b Profile"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.30"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"work_email":{"type":"string","minLength":3,"description":"Work email address to resolve to a B2B profile URL."}},"required":["work_email"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/b2b-social-email":{"post":{"operationId":"b2b-social-email","summary":"LeadMagic B2B Social to Email — resolve a B2B profile URL to a work email address.","tags":["B2b Social Email"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.15"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile_url":{"type":"string","minLength":1,"description":"B2B profile URL to resolve to a work email address."}},"required":["profile_url"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/company-funding":{"post":{"operationId":"company-funding","summary":"LeadMagic Company Funding — funding rounds, financials, competitors, and company insights from a domain or name.","tags":["Company Funding"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_domain":{"description":"The company's domain.","type":"string"},"company_name":{"description":"The company's name.","type":"string"}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/company-search":{"post":{"operationId":"company-search","summary":"LeadMagic Company Search — enrich a company from its domain, name, or B2B profile URL: size, industry, location, socials, and more.","tags":["Company Search"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_domain":{"description":"The company's domain, e.g. leadmagic.io.","type":"string"},"company_name":{"description":"The company's name.","type":"string"},"profile_url":{"description":"The company's B2B profile URL.","type":"string"}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/email-finder":{"post":{"operationId":"email-finder","summary":"LeadMagic Email Finder — find a verified work email address from a person's name and company (domain or company name).","tags":["Email Finder"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string","minLength":1,"description":"The person's first name."},"last_name":{"type":"string","minLength":1,"description":"The person's last name."},"domain":{"description":"The company's domain name, e.g. microsoft.com.","type":"string"},"company_name":{"description":"The company's name (used if domain is unknown).","type":"string"}},"required":["first_name","last_name"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/email-validate":{"post":{"operationId":"email-validate","summary":"LeadMagic Email Validation — validate an email address for deliverability and retrieve associated company information.","tags":["Email Validate"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","minLength":3,"description":"Email address to validate."},"first_name":{"description":"First name of the person (optional, improves matching).","type":"string"},"last_name":{"description":"Last name of the person (optional, improves matching).","type":"string"}},"required":["email"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/employee-finder":{"post":{"operationId":"employee-finder","summary":"LeadMagic Employee Finder — list employees of a company by name, paginated. Priced per requested `per_page` (0.05 credits per employee).","tags":["Employee Finder"],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0","max":"0.07"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_name":{"type":"string","minLength":1,"description":"Company to list employees for."},"page":{"description":"Page number. Default: 1.","type":"integer","minimum":1,"maximum":9007199254740991},"per_page":{"description":"Results per page (max 50). Default: 20. Determines the price for credit-per-result endpoints.","type":"integer","minimum":1,"maximum":50}},"required":["company_name"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/google-ads-search":{"post":{"operationId":"google-ads-search","summary":"LeadMagic Google Ads Search — find Google Ads a company is running, from its domain or name.","tags":["Google Ads Search"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_domain":{"description":"The company's domain.","type":"string"},"company_name":{"description":"The company's name.","type":"string"}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/job-countries":{"get":{"operationId":"job-countries","summary":"LeadMagic Job Countries — list of country IDs accepted by /api/jobs-finder. Free.","tags":["Job Countries"],"security":[],"responses":{"200":{"description":"Successful response"}}}},"/api/job-types":{"get":{"operationId":"job-types","summary":"LeadMagic Job Types — list of job types accepted by /api/jobs-finder. Free.","tags":["Job Types"],"security":[],"responses":{"200":{"description":"Successful response"}}}},"/api/jobs-finder":{"post":{"operationId":"jobs-finder","summary":"LeadMagic Jobs Finder — search job postings by company, title, location, experience level, or description keywords. Priced per requested `per_page` (1 credit per job).","tags":["Jobs Finder"],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0","max":"1.50"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_name":{"description":"Filter by company name.","type":"string"},"company_website":{"description":"Filter by company website.","type":"string"},"job_title":{"description":"Filter by job title.","type":"string"},"location":{"description":"Filter by job location.","type":"string"},"experience_level":{"description":"Required experience level.","type":"string","enum":["entry","mid","senior","executive"]},"job_description":{"description":"Keywords from the job description.","type":"string"},"country_id":{"description":"Country ID from GET /api/job-countries, e.g. \"US\".","type":"string"},"page":{"description":"Page number. Default: 1.","type":"integer","minimum":1,"maximum":9007199254740991},"per_page":{"description":"Results per page (max 50). Default: 20. Determines the price for credit-per-result endpoints.","type":"integer","minimum":1,"maximum":50}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/meta-ads-search":{"post":{"operationId":"meta-ads-search","summary":"LeadMagic Meta Ads Search — find Facebook/Instagram ads a company is running, from its domain or name.","tags":["Meta Ads Search"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_domain":{"description":"The company's domain.","type":"string"},"company_name":{"description":"The company's name.","type":"string"}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/mobile-finder":{"post":{"operationId":"mobile-finder","summary":"LeadMagic Mobile Finder — find mobile phone numbers from a B2B profile URL, work email, or personal email.","tags":["Mobile Finder"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.15"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile_url":{"description":"B2B profile URL (e.g. a LinkedIn profile).","type":"string"},"work_email":{"description":"Work email address.","type":"string"},"personal_email":{"description":"Personal email address.","type":"string"}}}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/personal-email-finder":{"post":{"operationId":"personal-email-finder","summary":"LeadMagic Personal Email Finder — find personal email addresses from a B2B profile URL.","tags":["Personal Email Finder"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.06"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile_url":{"type":"string","minLength":1,"description":"B2B profile URL to resolve to personal email addresses."}},"required":["profile_url"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/profile-search":{"post":{"operationId":"profile-search","summary":"LeadMagic Profile Search — get full profile details (role, company, location, history) from a B2B profile URL.","tags":["Profile Search"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile_url":{"type":"string","minLength":1,"description":"Full URL of the B2B profile (e.g. a LinkedIn profile)."}},"required":["profile_url"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}},"/api/role-finder":{"post":{"operationId":"role-finder","summary":"LeadMagic Role Finder — find people holding a specific role/position at a company.","tags":["Role Finder"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.06"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_title":{"type":"string","minLength":1,"description":"Role/position to look for, e.g. \"Developer\"."},"company_name":{"description":"The company's name.","type":"string"},"company_domain":{"description":"The company's domain.","type":"string"},"company_profile_url":{"description":"The company's B2B profile URL.","type":"string"}},"required":["job_title"]}}}},"responses":{"200":{"description":"Successful response"},"402":{"description":"Payment Required"}}}}}}