blackstack-enrichment 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1adb325c2208f76b6784af820b5045710678ace1b651e4bd9f7a6fcdb5db981
-  data.tar.gz: eb0455821bce876a0f6000147d5ca4a9987b2737ccd19684f57eb849368402e8
+  metadata.gz: 480a8f9e861397f1185da6959032036559c0df712b53627e5b52b907b81fd5ae
+  data.tar.gz: 73b28d0ee030c0b901ea0f8cf6893b64e146b6efa98b05c6e2a92bcc9fd81ad5
 SHA512:
-  metadata.gz: e80809e301cd4211e5de508ab54aefb7e8363a995e181686d9dff7d8ab7983201bb36056eb3192b5be29cf6d6182794b769f1748703a47f1d743b389e48a8f4a
-  data.tar.gz: 8a39e8e4b28ab8876c832aff9872b9af38ad80f3c5a1db9e88c3838b930361bc0d5805d857d811fd38711f58148db31325aa10c9e9edfa50c48acf1a77c4d6a8
+  metadata.gz: c6b4bfa7a069362a8cd4370e099855892a48fd46f62ca33d5ed773dd01cc09ef4ba4bc62e6bae6b6fff3cad181b36a0ace2dd8e731ffb65e982c6396f19f779a
+  data.tar.gz: 3f329e4cb00303d911d8724df8b002cab015c70d2119594d50744e6c29a4f4a0b60451be2e2323c8325289261ee65e4ec349b797ae5d129a5cd21518e5b02a95

data/blackstack-enrichment.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
     s.name        = 'blackstack-enrichment'
-    s.version     = '1.0.1'
-    s.date        = '2024-03-19'
+    s.version     = '1.0.3'
+    s.date        = '2024-04-22'
     s.summary     = "Ruby library for connecting some enrichment services like Apillo or FindyMail."
     s.description = "Ruby library for connecting some enrichment services like Apillo or FindyMail."
     s.authors     = ["Leandro Daniel Sardi"]

data/lib/blackstack-enrichment.rb

@@ -29,6 +29,7 @@ module BlackStack
             j = JSON.parse(ret)
             raise "Error: #{j['error_message']}" if j['error_message']
             raise "Error: #{j['error_code']}" if j['error_code']
+            raise "Error: #{j['error']}" if j['error']
             match = j['matches'].first
             return nil if match.nil?
             match['email']
@@ -40,7 +41,7 @@ module BlackStack
         #
         # 
         def find_person_from_name_and_company(name:, company:)
-            raise 'Error: apollo_apikey is required for find_person_from_linkedin_url operation.' if @apollo_apikey.nil?
+            raise 'Error: apollo_apikey is required for find_person_from_name_and_company operation.' if @apollo_apikey.nil?
 
             ret = `curl -X POST -H "Content-Type: application/json" -H "Cache-Control: no-cache" -d '{
                 "api_key": "#{@apollo_apikey}",
@@ -55,6 +56,7 @@ module BlackStack
             j = JSON.parse(ret)
             raise "Error: #{j['error_message']}" if j['error_message']
             raise "Error: #{j['error_code']}" if j['error_code']
+            raise "Error: #{j['error']}" if j['error']
             match = j['matches'].first
             return nil if match.nil?
             match['email']
@@ -66,7 +68,7 @@ module BlackStack
         #
         # 
         def find_person_from_name_and_domain(name:, domain:)
-            raise 'Error: apollo_apikey or findymail_apikey are required for find_person_from_linkedin_url operation.' if @apollo_apikey.nil? && @findymail_apikey.nil?
+            raise 'Error: apollo_apikey or findymail_apikey are required for find_person_from_name_and_domain operation.' if @apollo_apikey.nil? && @findymail_apikey.nil?
 
             if @findymail_apikey
                 ret = `curl --request POST \
@@ -96,11 +98,88 @@ module BlackStack
                 j = JSON.parse(ret)
                 raise "Error: #{j['error_message']}" if j['error_message']
                 raise "Error: #{j['error_code']}" if j['error_code']
+                raise "Error: #{j['error']}" if j['error']
                 match = j['matches'].first
                 return nil if match.nil?
                 return match['email']
             end
-        end # def find_person_from_name_and_website
+        end # def find_person_from_name_and_domain
+
+        # Retrieve the name, job position and email of a person from a list of allowed titles and company domain.
+        #
+        # Reference: https://apolloio.github.io/apollo-api-docs/?shell#people-api
+        #
+        # 
+        def find_persons_from_title_and_domain(titles:, domain:, limit: 1, calls_delay: 1)
+            raise 'Error: apollo_apikey is required for find_persons_from_title_and_domain operation.' if @apollo_apikey.nil?
+            b = []
+
+            # search leads
+            s = "curl -X POST -H \"Content-Type: application/json\" -H \"Cache-Control: no-cache\" -d '{
+                \"api_key\": \"#{@apollo_apikey}\",
+                \"page\" : 1,
+                \"per_page\": #{limit.to_s},
+                \"person_titles\": [\"#{titles.join('", "')}\"],
+                \"q_organization_domains\": \"#{domain}\",
+                \"contact_email_status\": [\"verified\"]
+            }' \"https://api.apollo.io/v1/mixed_people/search\""
+            ret = `#{s}`
+            j = JSON.parse(ret)
+            
+            raise "Error: #{j['error_message']}" if j['error_message']
+            raise "Error: #{j['error_message']}" if j['error_message']
+            raise "Error: #{j['error']}" if j['error']
+            
+            a = j['people']
+            return ret if a.nil?
+
+            a.each { |h|
+                # add delay to don't oberload the API
+                sleep calls_delay
+
+                i = {}
+                i['id'] = h['id']
+                i['first_name'] = h['first_name']
+                i['last_name'] = h['last_name']
+                i['title'] = h['title']
+                i['linkedin_url'] = h['linkedin_url']
+                i['facebook_url'] = h['facebook_url']
+
+                # find the email of the lead
+                s = "curl -X POST -H \"Content-Type: application/json\" -H \"Cache-Control: no-cache\" -d '{
+                    \"api_key\": \"#{@apollo_apikey}\",
+                    \"reveal_personal_emails\": true,
+                    \"id\": \"#{i['id']}\"
+                }' \"https://api.apollo.io/v1/people/match\""
+                ret = `#{s}`
+                j = JSON.parse(ret)
+
+                raise "Error: #{j['error_message']}" if j['error_message']
+                raise "Error: #{j['error_code']}" if j['error_code']
+                raise "Error: #{j['error']}" if j['error']
+
+                next if j['person'].nil?
+                k = j['person'] if j['person']
+
+                # append emails and phone numbers to the hash
+                i['emails'] = []
+                i['emails'] << k['email'] if k['email']
+                i['emails'] += k['personal_emails'] if k['personal_emails']
+
+                i['phone_numbers'] = []
+                i['phone_numbers'] = k['phone_numbers'].map { |o| {
+                    'value' => o['raw_number'],
+                    'type' => o['type']
+                } } if k['phone_numbers']
+
+                i['raw'] = k
+
+                b << i
+            }
+
+            # return
+            b
+        end # def find_persons_from_title_and_domain
 
     end # class Enrichment
 end # module BlackStack

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blackstack-enrichment
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.3
 platform: ruby
 authors:
 - Leandro Daniel Sardi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-03-19 00:00:00.000000000 Z
+date: 2024-04-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json