blackstack-enrichment 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c1adb325c2208f76b6784af820b5045710678ace1b651e4bd9f7a6fcdb5db981
+  data.tar.gz: eb0455821bce876a0f6000147d5ca4a9987b2737ccd19684f57eb849368402e8
+SHA512:
+  metadata.gz: e80809e301cd4211e5de508ab54aefb7e8363a995e181686d9dff7d8ab7983201bb36056eb3192b5be29cf6d6182794b769f1748703a47f1d743b389e48a8f4a
+  data.tar.gz: 8a39e8e4b28ab8876c832aff9872b9af38ad80f3c5a1db9e88c3838b930361bc0d5805d857d811fd38711f58148db31325aa10c9e9edfa50c48acf1a77c4d6a8

data/blackstack-enrichment.gemspec

@@ -0,0 +1,16 @@
+Gem::Specification.new do |s|
+    s.name        = 'blackstack-enrichment'
+    s.version     = '1.0.1'
+    s.date        = '2024-03-19'
+    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"]
+    s.email       = 'leandro@connectionsphere.com'
+    s.files       = [
+      'lib/blackstack-enrichment.rb',
+      'blackstack-enrichment.gemspec'
+    ]
+    s.homepage    = 'https://github.com/leandrosardi/blackstack-enrichment'
+    s.license     = 'MIT'
+    s.add_runtime_dependency 'json', '~> 2.6.3', '>= 2.6.3'
+end

data/lib/blackstack-enrichment.rb

@@ -0,0 +1,106 @@
+require 'json'
+
+module BlackStack
+    class Enrichment
+        @@apollo_apikey = nil
+
+        def initialize(h={})
+            @apollo_apikey = h[:apollo_apikey]
+            @findymail_apikey = h[:findymail_apikey]
+        end # def initialize
+
+        # Retrieve the email of a person from a LinkedIn URL
+        #
+        # Reference: https://apolloio.github.io/apollo-api-docs/?shell#enrichment-api
+        #
+        # 
+        def find_person_from_linkedin_url(url:)
+            raise 'Error: apollo_apikey is required for find_person_from_linkedin_url operation.' if @apollo_apikey.nil?
+
+            ret = `curl -X POST -H "Content-Type: application/json" -H "Cache-Control: no-cache" -d '{
+                "api_key": "#{@apollo_apikey}",
+                "reveal_personal_emails": true,
+                "details": [
+                    {
+                        "linkedin_url": "#{url}"
+                    }
+                ]
+            }' "https://api.apollo.io/api/v1/people/bulk_match"`
+            j = JSON.parse(ret)
+            raise "Error: #{j['error_message']}" if j['error_message']
+            raise "Error: #{j['error_code']}" if j['error_code']
+            match = j['matches'].first
+            return nil if match.nil?
+            match['email']
+        end # def find_person_email_from_linkedin_url
+
+        # Retrieve the email of a person from his name and company.
+        #
+        # Reference: https://apolloio.github.io/apollo-api-docs/?shell#enrichment-api
+        #
+        # 
+        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?
+
+            ret = `curl -X POST -H "Content-Type: application/json" -H "Cache-Control: no-cache" -d '{
+                "api_key": "#{@apollo_apikey}",
+                "reveal_personal_emails": true,
+                "details": [
+                    {
+                        "name": "#{name}",
+                        "organization_name": "#{company}"
+                    }
+                ]
+            }' "https://api.apollo.io/api/v1/people/bulk_match"`
+            j = JSON.parse(ret)
+            raise "Error: #{j['error_message']}" if j['error_message']
+            raise "Error: #{j['error_code']}" if j['error_code']
+            match = j['matches'].first
+            return nil if match.nil?
+            match['email']
+        end # def find_person_from_name_and_company
+
+        # Retrieve the email of a person from his name and company.
+        #
+        # Reference: https://apolloio.github.io/apollo-api-docs/?shell#enrichment-api
+        #
+        # 
+        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?
+
+            if @findymail_apikey
+                ret = `curl --request POST \
+                    "https://app.findymail.com/api/search/name" \
+                    --header "Authorization: Bearer #{@findymail_apikey}" \
+                    --header "Content-Type: application/json" \
+                    --header "Accept: application/json" \
+                    --data "{
+                        \\"name\\": \\"#{name}\\",
+                        \\"domain\\": \\"#{domain}\\"
+                    }"`
+                j = JSON.parse(ret)
+                raise "Error: #{j['error']}" if j['error']
+                return nil if j['contact'].nil?
+                return j['contact']['email']
+            elsif @apollo_apikey
+                ret = `curl -X POST -H "Content-Type: application/json" -H "Cache-Control: no-cache" -d '{
+                    "api_key": "#{@apollo_apikey}",
+                    "reveal_personal_emails": true,
+                    "details": [
+                        {
+                            "name": "#{name}",
+                            "domain": "#{domain}"
+                        }
+                    ]
+                }' "https://api.apollo.io/api/v1/people/bulk_match"`
+                j = JSON.parse(ret)
+                raise "Error: #{j['error_message']}" if j['error_message']
+                raise "Error: #{j['error_code']}" if j['error_code']
+                match = j['matches'].first
+                return nil if match.nil?
+                return match['email']
+            end
+        end # def find_person_from_name_and_website
+
+    end # class Enrichment
+end # module BlackStack

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: blackstack-enrichment
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Leandro Daniel Sardi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2024-03-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.6.3
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.6.3
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.3
+description: Ruby library for connecting some enrichment services like Apillo or FindyMail.
+email: leandro@connectionsphere.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- blackstack-enrichment.gemspec
+- lib/blackstack-enrichment.rb
+homepage: https://github.com/leandrosardi/blackstack-enrichment
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: Ruby library for connecting some enrichment services like Apillo or FindyMail.
+test_files: []