> ## Documentation Index
> Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete reference for all LeadMagic API endpoints

## Overview

The LeadMagic API provides RESTful endpoints for B2B data enrichment, email validation, contact discovery, company intelligence, and advertising insights.

All endpoints use `POST` requests with JSON bodies and return JSON responses. Authentication is done via the `X-API-Key` header.

> [card] [OpenAPI Specification](https://leadmagic.io/docs/v1/reference/openapi.yml)
>
> Download the full OpenAPI 3.1 specification for use with tools like Postman, Insomnia, or code generators.

## Authentication

All API requests require an API key passed in the `X-API-Key` header:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST 'https://api.leadmagic.io/v1/people/email-validation' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email": "alex.rivera@example.com"}'
```

> [!TIP]
>
> Get your API key from the [API Settings](https://app.leadmagic.io/settings/api) page. The header name is case-insensitive — `X-API-Key`, `X-API-KEY`, and `x-api-key` all work.

## Base URL

```
https://api.leadmagic.io
```

## All Endpoints

20+ endpoints across email, contact, company, jobs, and ads data. Every endpoint includes an interactive playground — click any card to try it live.

> [tab] Email
>
> > [card] [Email Validation](https://leadmagic.io/docs/v1/reference/email-validation.md)
> >
> > Verify emails with 99%+ accuracy. 4 validations per credit.
>
> > [card] [Email Finder](https://leadmagic.io/docs/v1/reference/email-finder.md)
> >
> > Find work emails from name + company. 1 credit.
>
> > [card] [Personal Email Finder](https://leadmagic.io/docs/v1/reference/personal-email-finder.md)
> >
> > Find personal email addresses. 2 credits.
>
> > [card] [B2B Person Profile to Email](https://leadmagic.io/docs/v1/reference/profile-to-email.md)
> >
> > Get work email from a B2B person profile. 5 credits.

> [tab] Contact
>
> > [card] [B2B Person Profile](https://leadmagic.io/docs/v1/reference/profile-search.md)
> >
> > Full B2B person profile with work history, education, skills. 1 credit.
>
> > [card] [Email to B2B Person Profile](https://leadmagic.io/docs/v1/reference/email-to-profile.md)
> >
> > Find B2B person profiles from email. 10 credits.
>
> > [card] [Mobile Finder](https://leadmagic.io/docs/v1/reference/mobile-finder.md)
> >
> > Direct mobile numbers for outreach. 5 credits.
>
> > [card] [Job Change Detector](https://leadmagic.io/docs/v1/reference/job-change-detector.md)
> >
> > Track when contacts change jobs. 3 credits.
>
> > [card] [Role Finder](https://leadmagic.io/docs/v1/reference/role-finder.md)
> >
> > Find people by title at a company. 2 credits.
>
> > [card] [People Search](https://leadmagic.io/docs/v1/reference/people-search.md)
> >
> > Search employees and decision-makers with all filters.

> [tab] Company
>
> > [card] [Company Search](https://leadmagic.io/docs/v1/reference/company-search.md)
> >
> > Firmographic data by domain or name. 1 credit.
>
> > [card] [Technographics](https://leadmagic.io/docs/v1/reference/technographics.md)
> >
> > Tech stacks companies use. 1 credit.
>
> > [card] [Company Funding](https://leadmagic.io/docs/v1/reference/company-funding.md)
> >
> > Funding rounds and investor data. 4 credits.
>
> > [card] [Company Lookalike](https://leadmagic.io/docs/v1/reference/company-lookalike.md)
> >
> > Discover similar companies from a seed account. 5 credits.

> [tab] Jobs
>
> > [card] [Jobs Finder](https://leadmagic.io/docs/v1/reference/jobs-finder.md)
> >
> > Search job listings across industries. 1 credit.
>
> **Filter endpoints** (free, no credits):
>
> > [card] [Countries](https://leadmagic.io/docs/v1/reference/job-country.md)
> >
> > Country codes for job filtering.
>
> > [card] [Regions](https://leadmagic.io/docs/v1/reference/job-regions.md)
> >
> > States/provinces for job filtering.
>
> > [card] [Employment Types](https://leadmagic.io/docs/v1/reference/job-types.md)
> >
> > Full-time, part-time, contract, etc.
>
> > [card] [Company Types](https://leadmagic.io/docs/v1/reference/job-company-types.md)
> >
> > Filter by company size/type.
>
> > [card] [Industries](https://leadmagic.io/docs/v1/reference/job-industry.md)
> >
> > Industry codes for filtering.

> [tab] Ads
>
> > [card] [Google Ads Search](https://leadmagic.io/docs/v1/reference/google-ads-search.md)
> >
> > Competitor search ads. 1 credit = 5 lookups.
>
> > [card] [Meta Ads Search](https://leadmagic.io/docs/v1/reference/meta-ads-search.md)
> >
> > Facebook/Instagram ads. 1 credit = 5 lookups.
>
> > [card] [B2B Ads Search](https://leadmagic.io/docs/v1/reference/b2b-ads-search.md)
> >
> > Professional network ads. 1 credit = 5 lookups.
>
> > [card] [B2B Ad Details](https://leadmagic.io/docs/v1/reference/b2b-ad-details.md)
> >
> > Full ad creative and metrics. 2 credits.

> [tab] Account
>
> > [card] [Check Credits](https://leadmagic.io/docs/v1/reference/check-credits.md)
> >
> > Monitor your credit balance. Free.
>
> > [card] [Analytics](https://leadmagic.io/docs/v1/reference/analytics.md)
> >
> > Usage stats, daily metrics, product breakdown. Free.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.