apollo-client 1.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5b290a27cca870cf8bbc810f511b93d306d744bc0400263afb5b8892c636c168
+  data.tar.gz: c54892abd0086c32e30d86494b2fb6bf56298b7effe5985b8d0cc554d8839177
+SHA512:
+  metadata.gz: 050d4d8ad3eeb064ce56c574cf93bc1ecb734ebbfea9f84d531a25af108dd5926be3b39142df6a17c8ee9ce74652f94020a738713a3d90a495a04005b08bc997
+  data.tar.gz: 5c74af95fd89c66242898fd0c1c7998c44d13518300de342472caed5f41b0d3c16f93f00409f92a916082df641aeeb0d1513f1274e3bed0f133cf884b480727e

data/apollo-client.gemspec

@@ -0,0 +1,16 @@
+Gem::Specification.new do |s|
+    s.name        = 'apollo-client'
+    s.version     = '1.0.4'
+    s.date        = '2025-01-08'
+    s.summary     = "Ruby library for connecting some enrichment services like Apillo."
+    s.description = "Ruby library for connecting some enrichment services like Apillo."
+    s.authors     = ["Leandro Daniel Sardi"]
+    s.email       = 'leandro@connectionsphere.com'
+    s.files       = [
+      'lib/apollo-client.rb',
+      'apollo-client.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/apollo-client.rb

@@ -0,0 +1,185 @@
+require 'json'
+
+#module BlackStack
+    class ApolloClient
+        @@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']
+            raise "Error: #{j['error']}" if j['error']
+            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_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}",
+                "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']
+            raise "Error: #{j['error']}" if j['error']
+            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_name_and_domain 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']
+                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_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 ApolloClient
+#end # module BlackStack

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: apollo-client
+version: !ruby/object:Gem::Version
+  version: 1.0.4
+platform: ruby
+authors:
+- Leandro Daniel Sardi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-01-08 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.
+email: leandro@connectionsphere.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- apollo-client.gemspec
+- lib/apollo-client.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.
+test_files: []