emailhunter 1.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4783ca3e6457c776875732582c772c3d1d112934384922f9816f22a401107b0
-  data.tar.gz: 2a12c9cb64c3ad77b9e902d0113ddc68b4c56c04c0530aa21e72b02523f9f58b
+  metadata.gz: 2006e973eb996d6b4285c772c1af115e0d96091c403fff927381233f4ebeed94
+  data.tar.gz: 51433f5603cbb512baedb0342eb83f7655505ae4a4ee5f4deac18d317d8861ae
 SHA512:
-  metadata.gz: 5e2b5c05259327cd62ceef07587518f755e57d4d577fff2bd4f38f1afba24b920d7d8ab0528ac27d86c80d53e4bdd3984a0a7d992a2d26d7f30141945b06bc32
-  data.tar.gz: 1ab01074fbe447ad24b2d39ce89bdf444b0b2cbdf280a615b94a17642bc350147135468d2651a7558fb00f6dc2cf271ca946e0291e3f5529d500d12bbc3f71d2
+  metadata.gz: 71a8eebcf7e1c0452a08d0d8ef4c79d980b1d48dbe0d898dab096b8012267dc2d7e7d4ade75ea861635dfa78690522b409993a60f065d3901299f85de161715f
+  data.tar.gz: 27c55a270224f1a9bc513c54903d0e5c16598bc939270dd331422dea13487c2fb733f5cb90f47efd83dd4628180730cf3baf9b1f90ff6ecff9bc1d2871c5103f

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in emailhunter.gemspec

data/README.md

@@ -1,6 +1,6 @@
 # EmailHunter
 
-A lightweight Ruby wrapper around Hunter (formerly Email Hunter) API, providing direct access to email search, verification, and company insights.
+A lightweight Ruby wrapper around [Hunter.io](https://hunter.io/) (formerly Email Hunter) API, providing direct access to email search, verification, and company insights.
 
 ## Installation
 
@@ -33,7 +33,20 @@ Your API key can be generated in your [Hunter dashboard](https://hunter.io).
 
 ## Features
 
+**Core APIs:**
+
+1. **Domain Search API** - Retrieve all email addresses associated with a domain
+2. **Email Verification API** - Check the deliverability of an email address
+3. **Email Finder API** - Find the most likely email using name and domain
+4. **Count API** - Get the number of email addresses for a domain (FREE)
+5. **Account Information API** - Retrieve details about your Hunter account
+6. **Company Information API** - Get company details using a domain name
+7. **People Search API** - Find key individuals associated with a company
+
+---
+
 ### 1. Domain Search API
+
 Retrieve all email addresses associated with a given domain.
 
 ```ruby
@@ -41,6 +54,7 @@ result = email_hunter.search('stripe.com')
 ```
 
 #### Response Fields:
+
 ```ruby
 result.fetch(:meta)
 result.fetch(:webmail)
@@ -50,6 +64,7 @@ result.fetch(:domain)
 ```
 
 ### 2. Email Verification API
+
 Check the deliverability of an email address.
 
 ```ruby
@@ -57,6 +72,7 @@ result = email_hunter.verify('bonjour@firmapi.com')
 ```
 
 #### Response Fields:
+
 ```ruby
 result.fetch(:result)
 result.fetch(:score)
@@ -72,6 +88,7 @@ result.fetch(:meta)
 ```
 
 ### 3. Email Finder API
+
 Guess the most likely email of a person using their first name, last name, and domain.
 
 ```ruby
@@ -79,6 +96,7 @@ result = email_hunter.finder('gmail.com', 'Davide', 'Santangelo')
 ```
 
 #### Response Fields:
+
 ```ruby
 result.fetch(:email)
 result.fetch(:score)
@@ -88,6 +106,7 @@ result.fetch(:meta)
 ```
 
 ### 4. Count API
+
 Retrieve the number of email addresses associated with a domain (FREE API call).
 
 ```ruby
@@ -95,12 +114,14 @@ result = email_hunter.count('gmail.com')
 ```
 
 #### Response Fields:
+
 ```ruby
 result.fetch(:data)
 result.fetch(:meta)
 ```
 
 ### 5. Company Information API (New Feature)
+
 Retrieve company details using a domain name.
 
 ```ruby
@@ -108,6 +129,7 @@ result = email_hunter.company('stripe.com')
 ```
 
 #### Response Fields:
+
 ```ruby
 result.fetch(:name)
 result.fetch(:industry)
@@ -117,6 +139,7 @@ result.fetch(:meta)
 ```
 
 ### 6. People Search API (New Feature)
+
 Retrieve key individuals associated with a company based on a domain name.
 
 ```ruby
@@ -124,6 +147,7 @@ result = email_hunter.people('stripe.com')
 ```
 
 #### Response Fields:
+
 ```ruby
 result.fetch(:employees)
 result.fetch(:position)
@@ -131,7 +155,177 @@ result.fetch(:email)
 result.fetch(:meta)
 ```
 
-### 7. Account Information API
+### 7. Discover API (New in v2.0.0)
+
+Search for companies using natural language queries.
+
+```ruby
+result = email_hunter.discover('US-based Software companies', limit: 10)
+```
+
+#### Response Fields:
+
+```ruby
+result.data  # Array of companies
+result.meta.fetch(:results)
+result.meta.fetch(:limit)
+result.meta.fetch(:offset)
+```
+
+### 8. Leads Management API (New in v2.0.0)
+
+Manage your leads stored in Hunter.
+
+#### List Leads:
+
+```ruby
+result = email_hunter.leads(limit: 20, offset: 0)
+```
+
+#### Create Lead:
+
+```ruby
+lead_data = {
+  email: 'john@example.com',
+  first_name: 'John',
+  last_name: 'Doe',
+  company: 'Example Inc',
+  position: 'CEO'
+}
+result = email_hunter.lead_create(lead_data)
+```
+
+#### Update Lead:
+
+```ruby
+update_data = { position: 'CTO' }
+result = email_hunter.lead_update(lead_id, update_data)
+```
+
+#### Delete Lead:
+
+```ruby
+success = email_hunter.lead_delete(lead_id)
+```
+
+#### Response Fields:
+
+```ruby
+result.data.leads  # Array of lead objects
+result.data.leads.first.email
+result.data.leads.first.company
+result.meta.fetch(:count)
+```
+
+### 9. Campaigns Management API (New in v2.0.0)
+
+Manage your email campaigns and recipients.
+
+#### List Campaigns:
+
+```ruby
+result = email_hunter.campaigns(limit: 20)
+```
+
+#### Get Campaign Recipients:
+
+```ruby
+result = email_hunter.campaign_recipients(campaign_id, limit: 20)
+```
+
+#### Add Recipient to Campaign:
+
+```ruby
+recipient_data = {
+  email: 'john@example.com',
+  first_name: 'John',
+  last_name: 'Doe'
+}
+result = email_hunter.campaign_add_recipient(campaign_id, recipient_data)
+```
+
+#### Remove Recipient from Campaign:
+
+```ruby
+success = email_hunter.campaign_delete_recipient(campaign_id, 'john@example.com')
+```
+
+#### Response Fields:
+
+```ruby
+result.data.campaigns  # Array of campaign objects
+result.data.recipients  # Array of recipient objects
+result.meta.fetch(:limit)
+```
+
+### 10. Lead Enrichment API (New in v2.0.0)
+
+Enrich person data with 100+ attributes using email or LinkedIn.
+
+```ruby
+# Using email
+result = email_hunter.lead_enrichment(email: 'matt@hunter.io')
+
+# Using LinkedIn
+result = email_hunter.lead_enrichment(linkedin: 'matttharp')
+```
+
+#### Response Fields:
+
+```ruby
+result.data.name.fullName
+result.data.email
+result.data.location
+result.data.timeZone
+result.data.employment.domain
+result.data.employment.title
+result.data.employment.name
+result.data.twitter.handle
+result.data.linkedin.handle
+result.meta.fetch(:email)
+```
+
+### 11. Company Enrichment API (New in v2.0.0)
+
+Enrich company data with detailed firmographic information.
+
+```ruby
+result = email_hunter.company_enrichment('stripe.com')
+```
+
+#### Response Fields:
+
+```ruby
+result.data.name
+result.data.description
+result.data.foundedYear
+result.data.location
+result.data.category.industry
+result.data.metrics.employees
+result.data.tech  # Array of technologies used
+result.data.site.emailAddresses
+result.meta.fetch(:domain)
+```
+
+### 12. Combined Enrichment API (New in v2.0.0)
+
+Get both lead and company data in a single call.
+
+```ruby
+result = email_hunter.combined_enrichment(email: 'patrick@stripe.com')
+```
+
+#### Response Fields:
+
+```ruby
+result.lead.data  # Lead enrichment data
+result.company.data  # Company enrichment data
+result.meta.email
+result.meta.domain
+```
+
+### 13. Account Information API
+
 Retrieve details about your Hunter account.
 
 ```ruby
@@ -139,21 +333,22 @@ result = email_hunter.account
 ```
 
 #### Response Example:
+
 ```json
 {
-   "data": {
-      "first_name": "Davide",
-      "last_name": "Santangelo",
-      "email": "davide.santangelo@gmail.com",
-      "plan_name": "Free",
-      "plan_level": 0,
-      "reset_date": "2025-06-29",
-      "team_id": 349,
-      "calls": {
-         "used": 4,
-         "available": 50
-      }
-   }
+  "data": {
+    "first_name": "Davide",
+    "last_name": "Santangelo",
+    "email": "davide.santangelo@gmail.com",
+    "plan_name": "Free",
+    "plan_level": 0,
+    "reset_date": "2025-06-29",
+    "team_id": 349,
+    "calls": {
+      "used": 4,
+      "available": 50
+    }
+  }
 }
 ```
 
@@ -168,4 +363,3 @@ The EmailHunter gem is released under the [MIT License](https://opensource.org/l
 3. Commit your changes (`git commit -am 'Add new feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new Pull Request
-

data/Rakefile

@@ -1 +1,3 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'

data/bin/console

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'bundler/setup'
 require 'emailhunter'

data/emailhunter.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Use require_relative to load the version file
 require_relative 'lib/email_hunter/version'
 
@@ -14,11 +16,11 @@ Gem::Specification.new do |spec|
     email discovery capabilities into your sales and marketing workflows.
   DESC
   spec.license       = 'MIT'
-  
+
   # Adding additional metadata improves discoverability
   spec.homepage      = 'https://github.com/davidesantangelo/emailhunter'
   spec.metadata      = {
-    "source_code_uri" => "https://github.com/davidesantangelo/emailhunter"
+    'source_code_uri' => 'https://github.com/davidesantangelo/emailhunter'
   }
 
   # Automatically include all version-controlled files except tests and specs

data/lib/email_hunter/account.rb

@@ -6,7 +6,7 @@ require 'json'
 module EmailHunter
   class Account
     API_URL = 'https://api.hunter.io/v2/account'
-    
+
     attr_reader :result, :first_name, :last_name, :email, :plan_name, :plan_level, :reset_date, :team_id, :calls,
                 :requests
 
@@ -28,10 +28,10 @@ module EmailHunter
 
     def parse_response(response)
       return nil unless response.success?
-      
+
       data = JSON.parse(response.body, symbolize_names: true)
       return nil if data.empty?
-      
+
       Struct.new(*data.keys).new(*data.values)
     end
   end

data/lib/email_hunter/api.rb

@@ -2,7 +2,8 @@
 
 require 'uri'
 
-%w[exist search finder verify count account company people].each do |file|
+%w[exist search finder verify count account company people discover leads campaigns lead_enrichment company_enrichment
+   combined_enrichment].each do |file|
   require_relative file
 end
 
@@ -44,7 +45,7 @@ module EmailHunter
     def account
       execute_hunt(Account)
     end
-    
+
     # Company Information API
     def company(domain)
       execute_hunt(Company, domain)
@@ -55,15 +56,75 @@ module EmailHunter
       execute_hunt(People, domain)
     end
 
+    # Discover API - Search companies using natural language
+    def discover(query, params = {})
+      execute_hunt(Discover, query, params)
+    end
+
+    # Leads API - List leads
+    def leads(params = {})
+      Leads.new(key, action: :list, params: params).hunt
+    end
+
+    # Leads API - Create lead
+    def lead_create(data)
+      Leads.new(key, action: :create, data: data).hunt
+    end
+
+    # Leads API - Update lead
+    def lead_update(id, data)
+      Leads.new(key, action: :update, lead_id: id, data: data).hunt
+    end
+
+    # Leads API - Delete lead
+    def lead_delete(id)
+      Leads.new(key, action: :delete, lead_id: id).hunt
+    end
+
+    # Campaigns API - List campaigns
+    def campaigns(params = {})
+      Campaigns.new(key, action: :list, params: params).hunt
+    end
+
+    # Campaigns API - Get campaign recipients
+    def campaign_recipients(campaign_id, params = {})
+      Campaigns.new(key, action: :recipients, campaign_id: campaign_id, params: params).hunt
+    end
+
+    # Campaigns API - Add recipient to campaign
+    def campaign_add_recipient(campaign_id, data)
+      Campaigns.new(key, action: :add_recipient, campaign_id: campaign_id, data: data).hunt
+    end
+
+    # Campaigns API - Delete recipient from campaign
+    def campaign_delete_recipient(campaign_id, email)
+      Campaigns.new(key, action: :delete_recipient, campaign_id: campaign_id, data: { email: email }).hunt
+    end
+
+    # Lead Enrichment API - Enrich person data
+    def lead_enrichment(email: nil, linkedin: nil)
+      LeadEnrichment.new(key, email: email, linkedin: linkedin).hunt
+    end
+
+    # Company Enrichment API - Enrich company data
+    def company_enrichment(domain)
+      CompanyEnrichment.new(domain, key).hunt
+    end
+
+    # Combined Enrichment API - Enrich both lead and company data
+    def combined_enrichment(email: nil, linkedin: nil)
+      CombinedEnrichment.new(key, email: email, linkedin: linkedin).hunt
+    end
+
     private
 
     # Helper method to reduce repetition
     def execute_hunt(klass, *args)
       case klass.name.split('::').last
-      when 'Search'
-        # Search expects (domain, key, params)
-        domain, params = args
-        klass.new(domain, key, params || {}).hunt
+      when 'Search', 'Discover'
+        # Search and Discover expect (value, key, params)
+        value, params = args
+        klass.new(value, key, params || {}).hunt
       when 'Count'
         # Count doesn't need key
         domain = args.first

data/lib/email_hunter/campaigns.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'ostruct'
+
+module EmailHunter
+  class Campaigns
+    API_URL = 'https://api.hunter.io/v2/campaigns'
+
+    attr_reader :key, :params, :action, :campaign_id, :data
+
+    def initialize(key, action: :list, campaign_id: nil, data: nil, params: {})
+      @key = key
+      @action = action
+      @campaign_id = campaign_id
+      @data = data
+      @params = params
+    end
+
+    def hunt
+      case action
+      when :list
+        list_campaigns
+      when :recipients
+        list_recipients
+      when :add_recipient
+        add_recipient
+      when :delete_recipient
+        delete_recipient
+      else
+        raise ArgumentError, "Unknown action: #{action}"
+      end
+    end
+
+    private
+
+    def list_campaigns
+      response_data = fetch_campaigns_data
+      return nil if response_data.empty?
+
+      # Convert to OpenStruct for easy access
+      result = OpenStruct.new(response_data)
+
+      # Convert campaigns array to OpenStruct objects if it exists
+      if result.data.is_a?(Hash) && result.data[:campaigns].is_a?(Array)
+        campaigns_array = result.data[:campaigns].map { |c| OpenStruct.new(c) }
+        result.data = OpenStruct.new(result.data.merge(campaigns: campaigns_array))
+      elsif result.data.is_a?(OpenStruct) && result.data.campaigns.is_a?(Array)
+        result.data.campaigns = result.data.campaigns.map { |c| OpenStruct.new(c) }
+      end
+
+      result
+    end
+
+    def list_recipients
+      response_data = fetch_recipients_data
+      return nil if response_data.empty?
+
+      result = OpenStruct.new(response_data)
+
+      # Convert recipients array to OpenStruct objects if it exists
+      if result.data.is_a?(Hash) && result.data[:recipients].is_a?(Array)
+        recipients_array = result.data[:recipients].map { |r| OpenStruct.new(r) }
+        result.data = OpenStruct.new(result.data.merge(recipients: recipients_array))
+      elsif result.data.is_a?(OpenStruct) && result.data.recipients.is_a?(Array)
+        result.data.recipients = result.data.recipients.map { |r| OpenStruct.new(r) }
+      end
+
+      result
+    end
+
+    def add_recipient
+      response_data = post_recipient_data
+      return nil if response_data.empty?
+
+      OpenStruct.new(response_data)
+    end
+
+    def delete_recipient
+      response = delete_recipient_data
+      response.success?
+    end
+
+    def fetch_campaigns_data
+      connection = Faraday.new
+      request_params = {
+        api_key: key,
+        limit: params.fetch(:limit, 20),
+        offset: params.fetch(:offset, 0)
+      }
+
+      response = connection.get(API_URL, request_params)
+
+      return {} unless response.success?
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def fetch_recipients_data
+      connection = Faraday.new
+      url = "#{API_URL}/#{campaign_id}/recipients"
+      request_params = {
+        api_key: key,
+        limit: params.fetch(:limit, 20),
+        offset: params.fetch(:offset, 0)
+      }
+
+      response = connection.get(url, request_params)
+
+      return {} unless response.success?
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def post_recipient_data
+      connection = Faraday.new
+      url = "#{API_URL}/#{campaign_id}/recipients"
+      request_data = data.merge(api_key: key)
+
+      response = connection.post(url) do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = request_data.to_json
+      end
+
+      return {} unless response.success?
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def delete_recipient_data
+      connection = Faraday.new
+      email = data[:email]
+      url = "#{API_URL}/#{campaign_id}/recipients/#{email}"
+
+      connection.delete(url, api_key: key)
+    end
+  end
+end

data/lib/email_hunter/combined_enrichment.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'ostruct'
+require_relative 'lead_enrichment'
+require_relative 'company_enrichment'
+
+module EmailHunter
+  class CombinedEnrichment
+    attr_reader :key, :email, :linkedin
+
+    def initialize(key, email: nil, linkedin: nil)
+      @key = key
+      @email = email
+      @linkedin = linkedin
+
+      raise ArgumentError, 'Either email or linkedin must be provided' if email.nil? && linkedin.nil?
+    end
+
+    def hunt
+      # First get lead enrichment data
+      lead_data = LeadEnrichment.new(key, email: email, linkedin: linkedin).hunt
+      return nil if lead_data.nil?
+
+      # Extract domain from employment if available
+      domain = lead_data.data.employment&.domain
+      return lead_data if domain.nil?
+
+      # Get company enrichment data
+      company_data = CompanyEnrichment.new(domain, key).hunt
+
+      # Combine the data
+      OpenStruct.new(
+        lead: lead_data,
+        company: company_data,
+        meta: OpenStruct.new(
+          email: email,
+          linkedin: linkedin,
+          domain: domain
+        )
+      )
+    rescue StandardError => e
+      # If company enrichment fails, just return lead data
+      OpenStruct.new(
+        lead: lead_data,
+        company: nil,
+        meta: OpenStruct.new(
+          email: email,
+          linkedin: linkedin,
+          error: e.message
+        )
+      )
+    end
+  end
+end

data/lib/email_hunter/company.rb

@@ -7,7 +7,7 @@ require 'ostruct'
 module EmailHunter
   class Company
     API_URL = 'https://api.hunter.io/v2/companies/find'
-    
+
     attr_reader :domain, :key
 
     def initialize(domain, key)
@@ -18,19 +18,19 @@ module EmailHunter
     def hunt
       response_data = fetch_company_data
       return nil if response_data.empty?
-      
+
       # Convert nested data structure to a Struct
       data = response_data[:data]
       meta = response_data[:meta]
-      
+
       result = OpenStruct.new(
         data: OpenStruct.new(data),
         meta: OpenStruct.new(meta)
       )
-      
+
       # Recursively convert nested hashes to OpenStructs for deeper access
       convert_hash_to_struct(result.data, data)
-      
+
       result
     end
 
@@ -40,7 +40,7 @@ module EmailHunter
       @fetch_company_data ||= begin
         connection = Faraday.new
         response = connection.get(API_URL, domain: domain, api_key: key)
-        
+
         return {} unless response.success?
 
         JSON.parse(response.body, symbolize_names: true)
@@ -58,4 +58,4 @@ module EmailHunter
       end
     end
   end
-end
+end

data/lib/email_hunter/company_enrichment.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'ostruct'
+
+module EmailHunter
+  class CompanyEnrichment
+    API_URL = 'https://api.hunter.io/v2/companies/find'
+
+    attr_reader :domain, :key
+
+    def initialize(domain, key)
+      @domain = domain
+      @key = key
+    end
+
+    def hunt
+      response_data = fetch_enrichment_data
+      return nil if response_data.empty?
+
+      # Convert nested data structure to OpenStruct
+      data = response_data[:data]
+      meta = response_data[:meta]
+
+      result = OpenStruct.new(
+        data: OpenStruct.new(data),
+        meta: OpenStruct.new(meta)
+      )
+
+      # Recursively convert nested hashes to OpenStructs for deeper access
+      convert_hash_to_struct(result.data, data)
+
+      result
+    end
+
+    private
+
+    def fetch_enrichment_data
+      @fetch_enrichment_data ||= begin
+        connection = Faraday.new
+        response = connection.get(API_URL, domain: domain, api_key: key)
+
+        return {} unless response.success?
+
+        JSON.parse(response.body, symbolize_names: true)
+      end
+    end
+
+    def convert_hash_to_struct(struct, hash)
+      hash.each do |key, value|
+        if value.is_a?(Hash)
+          struct[key] = OpenStruct.new(value)
+          convert_hash_to_struct(struct[key], value)
+        elsif value.is_a?(Array) && value.first.is_a?(Hash)
+          struct[key] = value.map { |item| OpenStruct.new(item) }
+        end
+      end
+    end
+  end
+end

data/lib/email_hunter/count.rb

@@ -6,7 +6,7 @@ require 'json'
 module EmailHunter
   class Count
     API_URL = 'https://api.hunter.io/v2/email-count'
-    
+
     attr_reader :domain
 
     def initialize(domain)
@@ -16,7 +16,7 @@ module EmailHunter
     def hunt
       response_data = fetch_count_data
       return nil if response_data.empty?
-      
+
       Struct.new(*response_data.keys).new(*response_data.values)
     end
 
@@ -26,7 +26,7 @@ module EmailHunter
       @fetch_count_data ||= begin
         connection = Faraday.new
         response = connection.get(API_URL, domain: domain)
-        
+
         return {} unless response.success?
 
         JSON.parse(response.body, symbolize_names: true)

data/lib/email_hunter/discover.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+
+module EmailHunter
+  class Discover
+    API_URL = 'https://api.hunter.io/v2/discover'
+
+    attr_reader :query, :key, :params
+
+    def initialize(query, key, params = {})
+      @query = query
+      @key = key
+      @params = params
+    end
+
+    def hunt
+      response_data = fetch_discover_data
+      return nil if response_data.empty?
+
+      # Convert to OpenStruct for easy access
+      result = OpenStruct.new(response_data)
+
+      # Recursively convert nested hashes to OpenStructs
+      convert_hash_to_struct(result, response_data)
+
+      result
+    end
+
+    private
+
+    def convert_hash_to_struct(struct, hash)
+      hash.each do |key, value|
+        if value.is_a?(Hash)
+          struct[key] = OpenStruct.new(value)
+          convert_hash_to_struct(struct[key], value)
+        elsif value.is_a?(Array) && value.first.is_a?(Hash)
+          struct[key] = value.map { |item| OpenStruct.new(item) }
+        end
+      end
+    end
+
+    def limit
+      params.fetch(:limit, 100).to_i
+    end
+
+    def offset
+      params.fetch(:offset, 0).to_i
+    end
+
+    def filters
+      params.fetch(:filters, {})
+    end
+
+    def fetch_discover_data
+      @fetch_discover_data ||= begin
+        connection = Faraday.new
+        request_data = {
+          query: query,
+          api_key: key,
+          limit: limit,
+          offset: offset
+        }
+
+        # Add filters if provided
+        request_data[:filters] = filters unless filters.empty?
+
+        response = connection.post(API_URL) do |req|
+          req.headers['Content-Type'] = 'application/json'
+          req.body = request_data.to_json
+        end
+
+        return {} unless response.success?
+
+        JSON.parse(response.body, symbolize_names: true)
+      end
+    end
+  end
+end

data/lib/email_hunter/exist.rb

@@ -6,7 +6,7 @@ require 'json'
 module EmailHunter
   class Exist
     API_URL = 'https://api.emailhunter.co/v1/exist'
-    
+
     attr_reader :email, :key
 
     def initialize(email, key)
@@ -17,7 +17,7 @@ module EmailHunter
     def hunt
       response_data = fetch_exist_data
       return nil if response_data.empty?
-      
+
       Struct.new(*response_data.keys).new(*response_data.values)
     end
 
@@ -27,7 +27,7 @@ module EmailHunter
       @fetch_exist_data ||= begin
         connection = Faraday.new
         response = connection.get(API_URL, email: email, api_key: key)
-        
+
         return {} unless response.success?
 
         JSON.parse(response.body, symbolize_names: true)

data/lib/email_hunter/finder.rb

@@ -6,7 +6,7 @@ require 'json'
 module EmailHunter
   class Finder
     API_FINDER_URL = 'https://api.hunter.io/v2/email-finder'
-    
+
     attr_reader :email, :score, :sources, :domain, :meta, :key, :first_name, :last_name
 
     def initialize(domain, first_name, last_name, key)
@@ -23,7 +23,7 @@ module EmailHunter
     def data
       @data ||= begin
         response = fetch_finder_data
-        
+
         return {} unless response.success?
 
         JSON.parse(response.body, symbolize_names: true)
@@ -40,7 +40,7 @@ module EmailHunter
         last_name: last_name,
         api_key: key
       }
-      
+
       connection.get(API_FINDER_URL, params)
     end
   end

data/lib/email_hunter/lead_enrichment.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'ostruct'
+
+module EmailHunter
+  class LeadEnrichment
+    API_URL = 'https://api.hunter.io/v2/people/find'
+
+    attr_reader :key, :email, :linkedin
+
+    def initialize(key, email: nil, linkedin: nil)
+      @key = key
+      @email = email
+      @linkedin = linkedin
+
+      raise ArgumentError, 'Either email or linkedin must be provided' if email.nil? && linkedin.nil?
+    end
+
+    def hunt
+      response_data = fetch_enrichment_data
+      return nil if response_data.empty?
+
+      # Convert nested data structure to OpenStruct
+      data = response_data[:data]
+      meta = response_data[:meta]
+
+      result = OpenStruct.new(
+        data: OpenStruct.new(data),
+        meta: OpenStruct.new(meta)
+      )
+
+      # Recursively convert nested hashes to OpenStructs for deeper access
+      convert_hash_to_struct(result.data, data)
+
+      result
+    end
+
+    private
+
+    def fetch_enrichment_data
+      @fetch_enrichment_data ||= begin
+        connection = Faraday.new
+        request_params = { api_key: key }
+
+        request_params[:email] = email if email
+        request_params[:linkedin_handle] = linkedin if linkedin
+
+        response = connection.get(API_URL, request_params)
+
+        return {} unless response.success?
+
+        JSON.parse(response.body, symbolize_names: true)
+      end
+    end
+
+    def convert_hash_to_struct(struct, hash)
+      hash.each do |key, value|
+        if value.is_a?(Hash)
+          struct[key] = OpenStruct.new(value)
+          convert_hash_to_struct(struct[key], value)
+        elsif value.is_a?(Array) && value.first.is_a?(Hash)
+          struct[key] = value.map { |item| OpenStruct.new(item) }
+        end
+      end
+    end
+  end
+end

data/lib/email_hunter/leads.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'ostruct'
+
+module EmailHunter
+  class Leads
+    API_URL = 'https://api.hunter.io/v2/leads'
+
+    attr_reader :key, :params, :action, :lead_id, :data
+
+    def initialize(key, action: :list, lead_id: nil, data: nil, params: {})
+      @key = key
+      @action = action
+      @lead_id = lead_id
+      @data = data
+      @params = params
+    end
+
+    def hunt
+      case action
+      when :list
+        list_leads
+      when :create
+        create_lead
+      when :update
+        update_lead
+      when :delete
+        delete_lead
+      else
+        raise ArgumentError, "Unknown action: #{action}"
+      end
+    end
+
+    private
+
+    def list_leads
+      response_data = fetch_leads_data
+      return nil if response_data.empty?
+
+      # Convert nested data structure to OpenStruct
+      result = OpenStruct.new(
+        data: OpenStruct.new(response_data[:data] || {}),
+        meta: OpenStruct.new(response_data[:meta] || {})
+      )
+
+      # Convert leads array to OpenStruct objects
+      result.data.leads = result.data.leads.map { |lead| OpenStruct.new(lead) } if result.data.leads.is_a?(Array)
+
+      result
+    end
+
+    def create_lead
+      response_data = post_lead_data
+      return nil if response_data.empty?
+
+      OpenStruct.new(response_data)
+    end
+
+    def update_lead
+      response_data = put_lead_data
+      return nil if response_data.empty?
+
+      OpenStruct.new(response_data)
+    end
+
+    def delete_lead
+      response = delete_lead_data
+      response.success?
+    end
+
+    def fetch_leads_data
+      @fetch_leads_data ||= begin
+        connection = Faraday.new
+        request_params = {
+          api_key: key,
+          limit: params.fetch(:limit, 20),
+          offset: params.fetch(:offset, 0)
+        }
+
+        # Add optional filters
+        request_params[:leads_list_id] = params[:leads_list_id] if params[:leads_list_id]
+
+        response = connection.get(API_URL, request_params)
+
+        return {} unless response.success?
+
+        JSON.parse(response.body, symbolize_names: true)
+      end
+    end
+
+    def post_lead_data
+      connection = Faraday.new
+      request_data = data.merge(api_key: key)
+
+      response = connection.post(API_URL) do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = request_data.to_json
+      end
+
+      return {} unless response.success?
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def put_lead_data
+      connection = Faraday.new
+      url = "#{API_URL}/#{lead_id}"
+      request_data = data.merge(api_key: key)
+
+      response = connection.put(url) do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = request_data.to_json
+      end
+
+      return {} unless response.success?
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def delete_lead_data
+      connection = Faraday.new
+      url = "#{API_URL}/#{lead_id}"
+
+      connection.delete(url, api_key: key)
+    end
+  end
+end

data/lib/email_hunter/people.rb

@@ -7,7 +7,7 @@ require 'ostruct'
 module EmailHunter
   class People
     API_URL = 'https://api.hunter.io/v2/people/find'
-    
+
     attr_reader :email, :key
 
     def initialize(email, key)
@@ -18,19 +18,19 @@ module EmailHunter
     def hunt
       response_data = fetch_people_data
       return nil if response_data.empty?
-      
+
       # Convert nested data structure to a Struct
       data = response_data[:data]
       meta = response_data[:meta]
-      
+
       result = OpenStruct.new(
         data: OpenStruct.new(data),
         meta: OpenStruct.new(meta)
       )
-      
+
       # Recursively convert nested hashes to OpenStructs for deeper access
       convert_hash_to_struct(result.data, data)
-      
+
       result
     end
 
@@ -40,7 +40,7 @@ module EmailHunter
       @fetch_people_data ||= begin
         connection = Faraday.new
         response = connection.get(API_URL, email: email, api_key: key)
-        
+
         return {} unless response.success?
 
         JSON.parse(response.body, symbolize_names: true)
@@ -58,4 +58,4 @@ module EmailHunter
       end
     end
   end
-end
+end

data/lib/email_hunter/search.rb

@@ -6,7 +6,7 @@ require 'json'
 module EmailHunter
   class Search
     API_URL = 'https://api.hunter.io/v2/domain-search'
-    
+
     attr_reader :domain, :key, :params
 
     def initialize(domain, key, params = {})
@@ -18,7 +18,7 @@ module EmailHunter
     def hunt
       response_data = fetch_search_data
       return nil if response_data.empty?
-      
+
       Struct.new(*response_data.keys).new(*response_data.values)
     end
 
@@ -41,10 +41,10 @@ module EmailHunter
           offset: offset,
           limit: limit
         }
-        
+
         request_params[:type] = params[:type] if params[:type]
         response = connection.get(API_URL, request_params)
-        
+
         return {} unless response.success?
 
         JSON.parse(response.body, symbolize_names: true)

data/lib/email_hunter/verify.rb

@@ -6,7 +6,7 @@ require 'json'
 module EmailHunter
   class Verify
     API_URL = 'https://api.hunter.io/v2/email-verifier'
-    
+
     attr_reader :email, :key
 
     def initialize(email, key)
@@ -17,7 +17,7 @@ module EmailHunter
     def hunt
       response_data = fetch_verify_data
       return nil if response_data.empty?
-      
+
       Struct.new(*response_data.keys).new(*response_data.values)
     end
 
@@ -27,7 +27,7 @@ module EmailHunter
       @fetch_verify_data ||= begin
         connection = Faraday.new
         response = connection.get(API_URL, email: email, api_key: key)
-        
+
         return {} unless response.success?
 
         JSON.parse(response.body, symbolize_names: true)

data/lib/email_hunter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EmailHunter
-  VERSION = '1.1.0'
+  VERSION = '2.0.0'
 end

data/lib/emailhunter.rb

@@ -1 +1,3 @@
+# frozen_string_literal: true
+
 require File.expand_path(File.join(File.dirname(__FILE__), './email_hunter'))

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: emailhunter
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Davide Santangelo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-28 00:00:00.000000000 Z
+date: 2025-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -132,10 +132,16 @@ files:
 - lib/email_hunter.rb
 - lib/email_hunter/account.rb
 - lib/email_hunter/api.rb
+- lib/email_hunter/campaigns.rb
+- lib/email_hunter/combined_enrichment.rb
 - lib/email_hunter/company.rb
+- lib/email_hunter/company_enrichment.rb
 - lib/email_hunter/count.rb
+- lib/email_hunter/discover.rb
 - lib/email_hunter/exist.rb
 - lib/email_hunter/finder.rb
+- lib/email_hunter/lead_enrichment.rb
+- lib/email_hunter/leads.rb
 - lib/email_hunter/people.rb
 - lib/email_hunter/search.rb
 - lib/email_hunter/verify.rb