Leads API

Manage your leads with a simple API call.

Open documentation

Build with the Leads API.

Control the leads you store in Hunter and use it as an all-in-one email outreach platform.

Add, update, and delete items in your Leads. Programmatically control the contact information you have saved in Hunter.

The Leads API lets you extract your leads' contact information in the format of a JSON response. You can also create, add, and delete leads using simple API calls.

GET
https://api.hunter.io/v2/leads
200 OK
{
  "data": {
    "leads": [
      {
        "id": 1,
        "email": "hoon@stripe.com",
        "first_name": "Jeremy",
        "last_name": "Hoon",
        "position": null,
        "company": "Stripe",
        "company_industry": null,
        "company_size": null,
        "confidence_score": null,
        "website": "stripe.com",
        "country_code": null,
        "source": null,
        "linkedin_url": null,
        "phone_number": null,
        "twitter": null,
        "sync_status": null,
        "notes": null,
        "sending_status": null,
        "last_activity_at": null,
        "last_contacted_at": null,
        "verification": {
          "date": "2021-01-01 12:00:00 UTC",
          "status": "deliverable"
        },
        "leads_list": {
          "id": 1,
          "name": "My leads list",
          "leads_count": 2
        },
        "created_at": "2021-01-01 12:00:00 UTC"
      },
      {
        "id": 2,
        "email": "alexis@reddit.com",
        "first_name": "Alexis",
        "last_name": "Ohanian",
        "position": "Cofounder",
        "company": "Reddit",
        "company_industry": null,
        "company_size": null,
        "confidence_score": 97,
        "website": "reddit.com",
        "country_code": "US",
        "source": null,
        "linkedin_url": null,
        "phone_number": null,
        "twitter": null,
        "sync_status": null,
        "notes": null,
        "sending_status": null,
        "last_activity_at": null,
        "last_contacted_at": null,
        "verification": {
          "date": "2021-01-01 12:00:00 UTC",
          "status": "deliverable"
        },
        "leads_list": {
          "id": 1,
          "name": "My leads list",
          "leads_count": 2
        },
        "created_at": "2021-01-01 12:00:00 UTC"
      }
    }
  },
  "meta": {
    "count": 2,
    "total": 2,
    "params": {
      "limit": 20,
      "offset": 0
    }
  }
}

Made for builders.

Hunter's API is RESTful, frictionless, and easy to get started with.

Free for everyone.

You don’t need a premium Hunter plan to use our API.

Fast and robust.

Hunter's API can support your tool seamlessly, with fast response times and near 100% uptime.

My company, SparkToro, has used Hunter to power our contact data features for years. It’s not just that we love it; it’s that our customers do. Working with Hunter is easy, the data’s great, our customers are happy; what more could you ask for?
Rand Fishkin CEO at SparkToro

Thinking of a specific workflow?

Browse our native integrations – we might have already built just what you need!

Discover our integrations
We use cookies
We use cookies to analyze how Hunter's website is used and personalize your experience. Learn more