> ## 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 title="OpenAPI Specification" icon="code" href="/docs/v1/reference/openapi.yml">
  Download the full OpenAPI 3.1 specification for use with tools like Postman, Insomnia, or code generators.
</Card>

## 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.
</Tip>

## 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.

<Tabs>
  <Tab title="Email" icon="envelope">
    <CardGroup cols={2}>
      <Card title="Email Validation" icon="envelope-circle-check" href="/docs/v1/reference/email-validation">
        Verify emails with 99%+ accuracy. 4 validations per credit.
      </Card>

      <Card title="Email Finder" icon="magnifying-glass" href="/docs/v1/reference/email-finder">
        Find work emails from name + company. 1 credit.
      </Card>

      <Card title="Personal Email Finder" icon="envelope" href="/docs/v1/reference/personal-email-finder">
        Find personal email addresses. 2 credits.
      </Card>

      <Card title="B2B Person Profile to Email" icon="at" href="/docs/v1/reference/profile-to-email">
        Get work email from a B2B person profile. 5 credits.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Contact" icon="user">
    <CardGroup cols={2}>
      <Card title="B2B Person Profile" icon="user-magnifying-glass" href="/docs/v1/reference/profile-search">
        Full B2B person profile with work history, education, skills. 1 credit.
      </Card>

      <Card title="Email to B2B Person Profile" icon="id-card" href="/docs/v1/reference/email-to-profile">
        Find B2B person profiles from email. 10 credits.
      </Card>

      <Card title="Mobile Finder" icon="phone" href="/docs/v1/reference/mobile-finder">
        Direct mobile numbers for outreach. 5 credits.
      </Card>

      <Card title="Job Change Detector" icon="arrow-right-arrow-left" href="/docs/v1/reference/job-change-detector">
        Track when contacts change jobs. 3 credits.
      </Card>

      <Card title="Role Finder" icon="user-tie" href="/docs/v1/reference/role-finder">
        Find people by title at a company. 2 credits.
      </Card>

      <Card title="People Search" icon="users" href="/docs/v1/reference/people-search">
        Search employees and decision-makers with all filters.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Company" icon="building">
    <CardGroup cols={2}>
      <Card title="Company Search" icon="building-magnifying-glass" href="/docs/v1/reference/company-search">
        Firmographic data by domain or name. 1 credit.
      </Card>

      <Card title="Technographics" icon="microchip" href="/docs/v1/reference/technographics">
        Tech stacks companies use. 1 credit.
      </Card>

      <Card title="Company Funding" icon="money-bill-trend-up" href="/docs/v1/reference/company-funding">
        Funding rounds and investor data. 4 credits.
      </Card>

      <Card title="Company Lookalike" icon="users-between-lines" href="/docs/v1/reference/company-lookalike">
        Discover similar companies from a seed account. 5 credits.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Jobs" icon="briefcase">
    <CardGroup cols={2}>
      <Card title="Jobs Finder" icon="briefcase" href="/docs/v1/reference/jobs-finder">
        Search job listings across industries. 1 credit.
      </Card>
    </CardGroup>

    **Filter endpoints** (free, no credits):

    <CardGroup cols={2}>
      <Card title="Countries" icon="globe" href="/docs/v1/reference/job-country">
        Country codes for job filtering.
      </Card>

      <Card title="Regions" icon="map" href="/docs/v1/reference/job-regions">
        States/provinces for job filtering.
      </Card>

      <Card title="Employment Types" icon="list" href="/docs/v1/reference/job-types">
        Full-time, part-time, contract, etc.
      </Card>

      <Card title="Company Types" icon="building" href="/docs/v1/reference/job-company-types">
        Filter by company size/type.
      </Card>

      <Card title="Industries" icon="industry" href="/docs/v1/reference/job-industry">
        Industry codes for filtering.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Ads" icon="rectangle-ad">
    <CardGroup cols={2}>
      <Card title="Google Ads Search" icon="magnifying-glass-chart" href="/docs/v1/reference/google-ads-search">
        Competitor search ads. 1 credit = 5 lookups.
      </Card>

      <Card title="Meta Ads Search" icon="rectangle-ad" href="/docs/v1/reference/meta-ads-search">
        Facebook/Instagram ads. 1 credit = 5 lookups.
      </Card>

      <Card title="B2B Ads Search" icon="rectangle-ad" href="/docs/v1/reference/b2b-ads-search">
        Professional network ads. 1 credit = 5 lookups.
      </Card>

      <Card title="B2B Ad Details" icon="chart-bar" href="/docs/v1/reference/b2b-ad-details">
        Full ad creative and metrics. 2 credits.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Account" icon="gauge">
    <CardGroup cols={2}>
      <Card title="Check Credits" icon="coins" href="/docs/v1/reference/check-credits">
        Monitor your credit balance. Free.
      </Card>

      <Card title="Analytics" icon="chart-line" href="/docs/v1/reference/analytics">
        Usage stats, daily metrics, product breakdown. Free.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>