Leadhex API Documentation

API-first lead enrichment for sales and marketing teams

Quick Start

  1. Create an account and add a payment method
  2. Generate your API key from the dashboard
  3. Start making requests to enrich leads

Authentication

Include your API key in the request header:

X-API-Key: lh_your_api_key_here

Or use Authorization header:

Authorization: Bearer lh_your_api_key_here

Rate Limits

API Endpoints

POST /api/enrich

Enrich a lead with LinkedIn profile and company information.

Request Body:

{
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "company_name": "Acme Corp"
}

Response:

{
  "personal_info": {
    "full_name": "John Doe",
    "first_name": "John",
    "last_name": "Doe",
    "headline": "CEO at Acme Corp",
    "email": "john@acmecorp.com",
    "location": "San Francisco, CA",
    "current_company": "Acme Corp",
    "current_title": "Chief Executive Officer",
    "connection_count": 500,
    "follower_count": 1200,
    "top_skills": ["Leadership", "Strategy", "Sales"],
    "languages": ["English", "Spanish"],
    "linkedin_url": "https://linkedin.com/in/johndoe"
  },
  "company_info": {
    "name": "Acme Corp",
    "description": "Leading provider of innovative solutions",
    "industry": "Technology",
    "employee_count": 150,
    "employee_range": "100-500",
    "follower_count": 5000,
    "website": "https://acmecorp.com",
    "headquarters": "San Francisco",
    "funding_rounds": 3,
    "latest_funding": "Series B"
  },
  "related_contacts": [
    {
      "first_name": "Jane",
      "last_name": "Smith",
      "position": "CTO",
      "linkedin_url": "https://linkedin.com/in/janesmith"
    }
  ]
}

Code Examples

cURL

curl -X POST https://leadhex.net/api/enrich \
  -H "X-API-Key: lh_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "company_name": "Acme Corp"
  }'

Python

import requests

url = "https://leadhex.net/api/enrich"
headers = {
    "X-API-Key": "lh_your_api_key_here",
    "Content-Type": "application/json"
}
data = {
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "company_name": "Acme Corp"
}

response = requests.post(url, headers=headers, json=data)
enriched_data = response.json()
print(enriched_data)

JavaScript

const response = await fetch('https://leadhex.net/api/enrich', {
  method: 'POST',
  headers: {
    'X-API-Key': 'lh_your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    linkedin_url: 'https://linkedin.com/in/johndoe',
    company_name: 'Acme Corp'
  })
});

const enrichedData = await response.json();
console.log(enrichedData);

Error Codes

400 Bad Request - Missing required parameters
401 Unauthorized - Invalid or missing API key
429 Rate Limit Exceeded - You've hit your daily limit
500 Server Error - Something went wrong on our end

Pricing

Pay-Per-Use

$0.05

per API request

How it works:

  • Only pay for what you use
  • Automatic billing every 7 days
  • No monthly subscription fees
  • Credit card stored securely via Stripe

Examples:

100 requests $5.00
500 requests $25.00
1,000 requests $50.00

Billing cycle: Every 7 days automatically

💡 Getting Started: Add a payment method in your dashboard to create API keys and start making requests. You'll only be charged for successful enrichment requests.

Support

Need help? Email us at support@leadhex.com or check our status page for any ongoing issues.