← Hunter

List Leads with Hunter API

Pipedream makes it easy to connect APIs for Hunter and 2,700+ other apps remarkably fast.

Trigger workflow on
HTTP requests, schedules and app events
Next, do this
List Leads with the Hunter API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
8 min
Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

Create a workflow to List Leads with the Hunter API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Configure the List Leads action
    1. Connect your Hunter account
    2. Optional- Select a Leads List ID
    3. Optional- Configure Email
    4. Optional- Configure First Name
    5. Optional- Configure Last Name
    6. Optional- Configure Position
    7. Optional- Configure Company
    8. Optional- Configure Industry
    9. Optional- Configure Website
    10. Optional- Configure Country Code
    11. Optional- Configure Company Size
    12. Optional- Configure Source
    13. Optional- Configure Twitter
    14. Optional- Configure LinkedIn URL
    15. Optional- Configure Phone Number
    16. Optional- Select a Sync Status
    17. Optional- Select one or more Sending Status
    18. Optional- Select one or more Verification Status
    19. Optional- Select a Last Activity
    20. Optional- Select a Last Contacted
    21. Optional- Configure Query
    22. Configure Limit
  2. Select a trigger to run your workflow on HTTP requests, schedules or app events
  3. Deploy the workflow
  4. Send a test event to validate your setup
  5. Turn on the trigger

Integrations

List Leads with Hunter API on New Requests (Payload Only) from HTTP / Webhook API
HTTP / Webhook + Hunter
 
Try it
List Leads with Hunter API on New Submission from Typeform API
Typeform + Hunter
 
Try it
List Leads with Hunter API on New Submission (Instant) from Jotform API
Jotform + Hunter
 
Try it
List Leads with Hunter API on New Scheduled Tasks from Pipedream API
Pipedream + Hunter
 
Try it
List Leads with Hunter API on New Download Counts from npm API
npm + Hunter
 
Try it

Details

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

List Leads on Hunter
Description:List all your leads with comprehensive filtering options. The leads are returned in sorted order, with the most recent leads appearing first. [See the documentation](https://hunter.io/api-documentation/v2#leads).
Version:0.0.1
Key:hunter-list-leads

Code

import app from "../../hunter.app.mjs";

export default {
  key: "hunter-list-leads",
  name: "List Leads",
  description: "List all your leads with comprehensive filtering options. The leads are returned in sorted order, with the most recent leads appearing first. [See the documentation](https://hunter.io/api-documentation/v2#leads).",
  version: "0.0.1",
  type: "action",
  props: {
    app,
    leadsListId: {
      propDefinition: [
        app,
        "leadsListId",
      ],
      description: "Only returns the leads belonging to this list.",
      optional: true,
    },
    email: {
      propDefinition: [
        app,
        "email",
      ],
      description: "Filter leads by email. Use `*` for any value, `~` for empty, or specific email.",
      optional: true,
    },
    firstName: {
      propDefinition: [
        app,
        "firstName",
      ],
      description: "Filter leads by first name. Use `*` for any value, `~` for empty, or specific name.",
      optional: true,
    },
    lastName: {
      propDefinition: [
        app,
        "lastName",
      ],
      description: "Filter leads by last name. Use `*` for any value, `~` for empty, or specific name.",
      optional: true,
    },
    position: {
      propDefinition: [
        app,
        "position",
      ],
      description: "Filter leads by position. Use `*` for any value, `~` for empty, or specific position.",
      optional: true,
    },
    company: {
      propDefinition: [
        app,
        "company",
      ],
      description: "Filter leads by company. Use `*` for any value, `~` for empty, or specific company.",
      optional: true,
    },
    industry: {
      propDefinition: [
        app,
        "industry",
      ],
      description: "Filter leads by industry. Use `*` for any value, `~` for empty, or specific industry.",
      optional: true,
    },
    website: {
      propDefinition: [
        app,
        "website",
      ],
      description: "Filter leads by website. Use `*` for any value, `~` for empty, or specific website.",
      optional: true,
    },
    countryCode: {
      propDefinition: [
        app,
        "countryCode",
      ],
      description: "Filter leads by country code (ISO 3166-1 alpha-2). Use `*` for any value, `~` for empty.",
      optional: true,
    },
    companySize: {
      propDefinition: [
        app,
        "companySize",
      ],
      description: "Filter leads by company size. Use `*` for any value, `~` for empty, or specific size.",
      optional: true,
    },
    source: {
      propDefinition: [
        app,
        "source",
      ],
      description: "Filter leads by source. Use `*` for any value, `~` for empty, or specific source.",
      optional: true,
    },
    twitter: {
      propDefinition: [
        app,
        "twitter",
      ],
      description: "Filter leads by Twitter handle. Use `*` for any value, `~` for empty, or specific handle.",
      optional: true,
    },
    linkedinUrl: {
      propDefinition: [
        app,
        "linkedinUrl",
      ],
      description: "Filter leads by LinkedIn URL. Use `*` for any value, `~` for empty, or specific URL.",
      optional: true,
    },
    phoneNumber: {
      propDefinition: [
        app,
        "phoneNumber",
      ],
      description: "Filter leads by phone number. Use `*` for any value, `~` for empty, or specific number.",
      optional: true,
    },
    syncStatus: {
      type: "string",
      label: "Sync Status",
      description: "Only returns the leads matching this synchronization status.",
      options: [
        "pending",
        "error",
        "success",
      ],
      optional: true,
    },
    sendingStatus: {
      type: "string[]",
      label: "Sending Status",
      description: "Only returns the leads matching these sending status(es).",
      options: [
        "clicked",
        "opened",
        "sent",
        "pending",
        "error",
        "bounced",
        "unsubscribed",
        "replied",
        {
          value: "~",
          label: "unset",
        },
      ],
      optional: true,
    },
    verificationStatus: {
      type: "string[]",
      label: "Verification Status",
      description: "Only returns the leads matching these verification status(es).",
      options: [
        "accept_all",
        "disposable",
        "invalid",
        "unknown",
        "valid",
        "webmail",
        "pending",
      ],
      optional: true,
    },
    lastActivityAt: {
      type: "string",
      label: "Last Activity",
      description: "Only returns the leads matching this last activity.",
      options: [
        {
          value: "*",
          label: "any",
        },
        {
          value: "~",
          label: "unset",
        },
      ],
      optional: true,
    },
    lastContactedAt: {
      type: "string",
      label: "Last Contacted",
      description: "Only returns the leads matching this last contact date.",
      options: [
        {
          value: "*",
          label: "any",
        },
        {
          value: "~",
          label: "unset",
        },
      ],
      optional: true,
    },
    query: {
      type: "string",
      label: "Query",
      description: "Only returns the leads with **First Name**, **Last Name**, or **Email** matching the query.",
      optional: true,
    },
    limit: {
      propDefinition: [
        app,
        "limit",
      ],
      description: "A limit on the number of leads to be returned. Limit can range between `1` and `1,000`. Default is `20`.",
      min: 1,
      max: 1000,
    },
  },
  async run({ $ }) {
    const {
      app,
      leadsListId,
      email,
      firstName,
      lastName,
      position,
      company,
      industry,
      website,
      countryCode,
      companySize,
      source,
      twitter,
      linkedinUrl,
      phoneNumber,
      syncStatus,
      sendingStatus,
      verificationStatus,
      lastActivityAt,
      lastContactedAt,
      query,
      limit,
    } = this;

    const response = await app.listLeads({
      $,
      params: {
        limit,
        leads_list_id: leadsListId,
        email,
        first_name: firstName,
        last_name: lastName,
        position,
        company,
        industry,
        website,
        country_code: countryCode,
        company_size: companySize,
        source,
        twitter,
        linkedin_url: linkedinUrl,
        phone_number: phoneNumber,
        sync_status: syncStatus,
        query,
        last_activity_at: lastActivityAt,
        last_contacted_at: lastContactedAt,
        ...(Array.isArray(sendingStatus) && sendingStatus.length && {
          ["sending_status[]"]: sendingStatus,
        }),
        ...(Array.isArray(verificationStatus) && verificationStatus.length && {
          ["verification_status[]"]: verificationStatus,
        }),
      },
    });

    $.export("$summary", "Successfully retrieved leads");
    return response;
  },
};

Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.
LabelPropTypeDescription
HunterappappThis component uses the Hunter app.
Leads List IDleadsListIdstringSelect a value from the drop down menu.
Emailemailstring

Filter leads by email. Use * for any value, ~ for empty, or specific email.

First NamefirstNamestring

Filter leads by first name. Use * for any value, ~ for empty, or specific name.

Last NamelastNamestring

Filter leads by last name. Use * for any value, ~ for empty, or specific name.

Positionpositionstring

Filter leads by position. Use * for any value, ~ for empty, or specific position.

Companycompanystring

Filter leads by company. Use * for any value, ~ for empty, or specific company.

Industryindustrystring

Filter leads by industry. Use * for any value, ~ for empty, or specific industry.

Websitewebsitestring

Filter leads by website. Use * for any value, ~ for empty, or specific website.

Country CodecountryCodestring

Filter leads by country code (ISO 3166-1 alpha-2). Use * for any value, ~ for empty.

Company SizecompanySizestring

Filter leads by company size. Use * for any value, ~ for empty, or specific size.

Sourcesourcestring

Filter leads by source. Use * for any value, ~ for empty, or specific source.

Twittertwitterstring

Filter leads by Twitter handle. Use * for any value, ~ for empty, or specific handle.

LinkedIn URLlinkedinUrlstring

Filter leads by LinkedIn URL. Use * for any value, ~ for empty, or specific URL.

Phone NumberphoneNumberstring

Filter leads by phone number. Use * for any value, ~ for empty, or specific number.

Sync StatussyncStatusstringSelect a value from the drop down menu:pendingerrorsuccess
Sending StatussendingStatusstring[]Select a value from the drop down menu:clickedopenedsentpendingerrorbouncedunsubscribedreplied{ "value": "~", "label": "unset" }
Verification StatusverificationStatusstring[]Select a value from the drop down menu:accept_alldisposableinvalidunknownvalidwebmailpending
Last ActivitylastActivityAtstringSelect a value from the drop down menu:{ "value": "*", "label": "any" }{ "value": "~", "label": "unset" }
Last ContactedlastContactedAtstringSelect a value from the drop down menu:{ "value": "*", "label": "any" }{ "value": "~", "label": "unset" }
Queryquerystring

Only returns the leads with First Name, Last Name, or Email matching the query.

Limitlimitinteger

A limit on the number of leads to be returned. Limit can range between 1 and 1,000. Default is 20.

Authentication

Hunter uses API keys for authentication. When you connect your Hunter account, Pipedream securely stores the keys so you can easily authenticate to Hunter APIs in both code and no-code steps.

About Hunter

Verify professional email addresses

More Ways to Use Hunter

Actions

Account Information with the Hunter API

Get information about your Hunter account. See the documentation

 
Try it
Combined Enrichment with the Hunter API

Returns all the information associated with an email address and its domain name. See the documentation

 
Try it
Create Lead with the Hunter API

Create a new lead in your Hunter account. See the documentation

 
Try it
Delete Lead with the Hunter API

Delete an existing lead from your Hunter account. See the documentation

 
Try it
Domain Search with the Hunter API

Search all the email addresses corresponding to one website or company. See the documentation

 
Try it

Explore Other Apps

1
-
24
of
2,700+
apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
Pipedream Utils
Pipedream Utils
Utility functions to use within your Pipedream workflows
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Anthropic (Claude)
Anthropic (Claude)
AI research and products that put safety at the frontier. Introducing Claude, a next-generation AI assistant for your tasks, no matter the scale.
Google Sheets
Google Sheets
Use Google Sheets to create and edit online spreadsheets. Get insights together with secure sharing in real-time and from any device.
Telegram
Telegram
Telegram, is a cloud-based, cross-platform, encrypted instant messaging (IM) service.
Google Drive
Google Drive
Google Drive is a file storage and synchronization service which allows you to create and share your work online, and access your documents from anywhere.
Pinterest
Pinterest
Pinterest is a visual discovery engine for finding ideas like recipes, home and style inspiration, and more.
Google Calendar
Google Calendar
With Google Calendar, you can quickly schedule meetings and events and get reminders about upcoming activities, so you always know what’s next.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Premium
ServiceNow
ServiceNow
The smarter way to workflow
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.