Quickstart

Make your first API call in under 5 minutes

Get started with LeadMagic in minutes. This guide walks you through making your first API call and exploring our interactive playground.

Fastest way to start: Skip the code and use our API Playground - test any endpoint directly in your browser!

Step 1: Get Your API Key

1. Create an account

   Sign up for free or log in if you already have an account.

2. Navigate to API Settings

   Go to Settings > API in your dashboard.

3. Copy your API key

   Click the copy button to copy your API key to clipboard.

   Keep your API key secret. Never expose it in client-side code or public repositories.

Step 2: Try the API Playground

The fastest way to test LeadMagic is our interactive API Playground. No code required!

Email Validation

Verify an email address instantly.

Email Finder

Find an email from name + company.

How to Use the Playground

1. Go to any API Reference page

   Click any endpoint in the sidebar or the cards above.

2. Enter your API key

   Paste your API key in the authentication section.

3. Fill in the parameters

   Enter test data (e.g., an email to validate).

4. Click 'Send'

   See the live response immediately!

The playground shows you exactly what your code will return - perfect for testing before integration.

Step 3: Make Your First API Call

Ready to integrate? Here’s how to call the API from your code:

cURL

curl -X POST 'https://api.leadmagic.io/v1/people/email-validation' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"email": "[e-mail]"}'

JavaScript

const response = await fetch('https://api.leadmagic.io/v1/people/email-validation', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.LEADMAGIC_API_KEY
  },
  body: JSON.stringify({ email: '[e-mail]' })
});

const data = await response.json();
console.log(data.email_status); // "valid", "invalid", or "unknown"

Python

import requests
import os

response = requests.post(
    'https://api.leadmagic.io/v1/people/email-validation',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': os.environ['LEADMAGIC_API_KEY']
    },
    json={'email': '[e-mail]'}
)

data = response.json()
print(data['email_status'])  # "valid", "invalid", or "unknown"

Example Response

{
  "email_status": "valid",
  "email": "[e-mail]",
  "domain": "leadmagic.io",
  "credits_consumed": 0.25,
  "company": {
    "name": "LeadMagic",
    "domain": "leadmagic.io",
    "linkedin_url": "https://linkedin.com/company/leadmagichq"
  }
}

Bonus: Every email validation includes free company enrichment data!

Step 4: Explore More Endpoints

Now that you’ve made your first call, explore other powerful endpoints:

Find Emails

Get professional emails from name + company domain.

Find Mobile Numbers

Discover direct mobile numbers for outreach.

Enrich Profiles

Get complete professional profiles with work history.

Search Companies

Enrich company data by domain or name.

These are our most popular endpoints. See the full API Reference for all 20+ endpoints across email, contact, company, jobs, and ads data.

Common Use Cases

Clean Your Email List

Goal: Remove invalid emails before a campaign

1. Loop through your email list
2. Call Email Validation for each
3. Keep only valid emails
4. Remove invalid, skip unknown (free, retry later)

Result: Higher deliverability, protected sender reputation

Build a Prospect List

Goal: Get contact info for target accounts

1. Start with company domains
2. Use Role Finder to find decision-makers
3. Use Email Finder for work emails
4. Use Mobile Finder for phone numbers

Result: Complete contact list for outreach

Enrich CRM Data

Goal: Fill in missing CRM fields

1. Export contacts with LinkedIn URLs
2. Use Profile Search for full profiles
3. Use Company Search for company data
4. Import enriched data back to CRM

Result: Rich CRM data for better personalization

What’s Next?

Making API Calls

Production request patterns, status codes, and retries.

Authentication Guide

Secure API key usage and key rotation best practices.

Developer Experience

Headers, observability, error handling, and analytics endpoints.

API Playground

Test any endpoint interactively.