Find and enrich B2B contacts, emails, mobile numbers, and company data
Integrate LeadMagic to find verified work emails by name or company, validate email deliverability, find direct mobile numbers, enrich LinkedIn profiles, reverse-lookup profiles from emails, search companies by domain, identify role holders at accounts, and check account credit balance.
Verify an email address for deliverability. Charges 0.25 credits for definitive SMTP results (valid/invalid); unknown and RFC-invalid results are free.
| 参数 | 类型 | 必填 | 描述 |
|---|
email | string | 是 | Email address to validate (e.g., john@example.com) |
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
email | string | The validated email address |
email_status | string | Validation result: valid, invalid, or unknown |
is_domain_catch_all | boolean | Whether the domain accepts all emails (catch-all) |
credits_consumed | number | Credits charged for this request (0.25 for definitive results) |
message | string | Human-readable status message |
mx_record | string | MX record for the domain |
mx_provider | string | Email provider (e.g., Google, Microsoft) |
mx_gateway | string | MX gateway for the domain |
mx_security_gateway | boolean | Whether the domain uses a security gateway |
company_name | string | Company name associated with the email domain |
company_industry | string | Industry of the company |
company_size | string | Company size range |
Find someone's verified work email from their name and company domain. Charges 1 credit when a valid email is found; free when no result.
| 参数 | 类型 | 必填 | 描述 |
|---|
first_name | string | 否 | Person's first name (use with last_name, or use full_name instead) |
last_name | string | 否 | Person's last name (use with first_name, or use full_name instead) |
full_name | string | 否 | Person's full name (alternative to first_name + last_name) |
domain | string | 否 | Company domain (preferred, e.g. stripe.com) |
company_name | string | 否 | Company name (fallback if domain is unavailable) |
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
email | string | Found work email address |
status | string | Result status (valid, invalid, etc.) |
credits_consumed | number | Credits charged (1 when email found) |
message | string | Human-readable status message |
employment_verified | boolean | Whether employment at the company was verified |
has_mx | boolean | Whether the domain has a valid MX record |
mx_record | string | MX record for the email domain |
mx_provider | string | Email provider |
company_name | string | Company name |
company_industry | string | Company industry |
company_size | string | Company size range |
company_profile_url | string | Company LinkedIn/B2B profile URL |
Find a person's direct mobile number from their LinkedIn profile URL or email. Charges 5 credits when a number is found; free when no result.
| 参数 | 类型 | 必填 | 描述 |
|---|
profile_url | string | 否 | LinkedIn profile URL (provide at least one identifier) |
work_email | string | 否 | Work email address (provide at least one identifier) |
personal_email | string | 否 | Personal email address (provide at least one identifier) |
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
profile_url | string | LinkedIn profile URL used for lookup |
email | string | Email address associated with the profile |
mobile_number | string | Direct mobile phone number |
credits_consumed | number | Credits charged (5 when mobile found) |
message | string | Status message from the API |
Enrich a LinkedIn profile with work history, education, skills, and contact data. Charges 1 credit per successful enrichment; free when profile not found.
| 参数 | 类型 | 必填 | 描述 |
|---|
profile_url | string | 是 | LinkedIn profile URL or username (e.g., https://linkedin.com/in/johndoe\) |
extended_response | boolean | 否 | Include additional profile image URL in the response (default: false) |
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
profile_url | string | LinkedIn profile URL |
first_name | string | First name |
last_name | string | Last name |
full_name | string | Full name |
professional_title | string | Current job title |
bio | string | Profile bio / summary |
location | string | Location string |
country | string | Country |
followers_range | string | LinkedIn follower range |
company_name | string | Current employer |
company_industry | string | Industry of current employer |
company_website | string | Company website |
total_tenure_years | string | Total professional tenure in years |
total_tenure_months | string | Total professional tenure in months |
work_experience | array | Work history entries |
education | array | Education history entries |
certifications | array | Professional certifications |
credits_consumed | number | Credits charged (1 when profile found) |
message | string | Human-readable status message |
Extract a verified work email from a LinkedIn profile URL. Charges 5 credits when an email is found; free when no result.
| 参数 | 类型 | 描述 |
|---|
email | string | Work email address found for this profile |
profile_url | string | LinkedIn profile URL used for lookup |
credits_consumed | number | Credits charged (5 when email found) |
message | string | Human-readable status message |
Retrieve a LinkedIn profile URL from a work or personal email address. Charges 10 credits when a profile is found; free when no result.
| 参数 | 类型 | 必填 | 描述 |
|---|
work_email | string | 否 | Work email address (provide at least one of work_email or personal_email) |
personal_email | string | 否 | Personal email address (provide at least one of work_email or personal_email) |
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
profile_url | string | LinkedIn profile URL for the provided email |
credits_consumed | number | Credits charged (10 when profile found) |
message | string | Human-readable status message |
Enrich company data including firmographics, headcount, funding, and social profiles by domain, LinkedIn URL, or name. Charges 1 credit when a company is found; free when no result.
| 参数 | 类型 | 必填 | 描述 |
|---|
company_domain | string | 否 | Company website domain (e.g., stripe.com). Provide at least one identifier. |
profile_url | string | 否 | LinkedIn company profile URL (e.g., https://linkedin.com/company/stripe\). Provide at least one identifier. |
company_name | string | 否 | Company name (fallback if domain/URL unavailable). Provide at least one identifier. |
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
companyName | string | Company name |
companyId | number | Internal company identifier |
industry | string | Industry classification |
employeeCount | number | Number of employees |
employeeRange | string | Headcount range (e.g., 1001-5000) |
founded | number | Year the company was founded |
headquarters | json | Headquarters location object |
revenue | string | Revenue range |
funding | string | Total funding amount |
description | string | Company description |
specialties | array | Company specialties and focus areas |
competitors | array | Competitor companies |
followerCount | number | LinkedIn follower count |
twitter_url | string | Twitter/X profile URL |
facebook_url | string | Facebook page URL |
b2b_profile_url | string | LinkedIn company profile URL |
logo_url | string | Company logo URL |
credits_consumed | number | Credits charged (1 when company found) |
message | string | Human-readable status message |
Find the person holding a specific job role at a company. Charges 2 credits when a matching person is found; free when no result.
| 参数 | 类型 | 必填 | 描述 |
|---|
job_title | string | 是 | Job role to search for (e.g., Head of Sales, CTO). Supports partial matching. |
company_domain | string | 否 | Company website domain (e.g., stripe.com). Provide domain or company_name. |
company_name | string | 否 | Company name (fallback if domain unavailable). Provide domain or company_name. |
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
first_name | string | First name of the person found |
last_name | string | Last name of the person found |
full_name | string | Full name of the person found |
profile_url | string | LinkedIn profile URL |
job_title | string | Verified job title at the company |
company_name | string | Company name |
company_website | string | Company website |
credits_consumed | number | Credits charged (2 when person found) |
message | string | Human-readable status message |
Retrieve the current credit balance for the authenticated LeadMagic account. This endpoint is free and consumes no credits.
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | LeadMagic API Key |
| 参数 | 类型 | 描述 |
|---|
credits | number | Current credit balance |
