peopledatalabs 1.0.2 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d078a93c2dc3607c0ccd632210a451f0f7f56bf1f1fd20a886cb9935af5113ac
-  data.tar.gz: be3d3ddc4de6b359a0fa78ddd0466e9e14e7ab28c9a38a5080e61eee8b6a2d80
+  metadata.gz: dcb0f2f6c5fe56216eaddb042b16fc105686ab2be354fe26f04e4bfe5948e69f
+  data.tar.gz: a101dbec0783f6fb2c2a3164a768f8acce0a13a8231e659dc647e9f85309f592
 SHA512:
-  metadata.gz: 40214ff087b274b0ab09f33e83372c5290842eae8adf16ccf38593173d3f6bf9f569a3b9fd2a9450950ab153fa0efccd7bafce7e640b392e9d6ace0d61b046df
-  data.tar.gz: aa161a86391ec1c03a2828290792e0d56c35e6776a4306befdc25184b079a8d4c8bfbf2ec08e27743621b6fa388964ef2015dc18f4890adbad8699b63b37393c
+  metadata.gz: b34e354eddf849a0da5734321c551557228066af39d5b7c870cf0f7ac5e4d8a966d1a134c6e8ea59017b2016b69b856c1a80f08f92400bbe2c86d8d9e8f5aa1f
+  data.tar.gz: 8239c66f3480b7e1022fd98774f0bfea305c745f06af7e1290baedf193c7e26c6134ae5ab29ffd89ba24642d51832c640874a4bc8e3fa120f4c6d9d8e8b8ed9c

data/.gitignore

@@ -14,6 +14,7 @@
 /test/version_tmp/
 /tmp/
 /.idea
+.env
 
 
 # Used by dotenv library to load environment variables.

data/README.md

@@ -24,8 +24,10 @@ This library bundles up PDL API requests into simple function calls, making it e
 ## Table of Contents
 - [🔧 Installation](#installation)
 - [🚀 Usage](#usage)
+- [🏝 Sandbox Usage](#sandbox)
 - [🌐 Endpoints](#endpoints)
 - [📘 Documentation](#documentation)
+- [⚠️ Upgrading from v1.X.X to v2.0.0](#upgrading)
 
 ## Installation <a name="installation"></a>
 
@@ -58,19 +60,19 @@ Peopledatalabs.api_key = 'api_key'
 
 Then, send requests to any PDL API Endpoint:
 
-**Getting Person Data**
+**Using Person APIs**
 ```ruby
 # By Enrichment
 Peopledatalabs::Enrichment.person(params: { phone: '4155688415' })
 
 # By Bulk Enrichment
-Peopledatalabs::Bulk.people(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
+Peopledatalabs::Bulk.person(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
 
 # By Search (SQL)
-Peopledatalabs::Search.people(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
+Peopledatalabs::Search.person(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
 
 # By Search (Elasticsearch)
-Peopledatalabs::Search.people(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
+Peopledatalabs::Search.person(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
 
 # By PDL_ID
 Peopledatalabs::Retrieve.person(person_id: 'qEnOZ5Oh0poWnQ1luFBfVw_0000')
@@ -79,7 +81,7 @@ Peopledatalabs::Retrieve.person(person_id: 'qEnOZ5Oh0poWnQ1luFBfVw_0000')
 Peopledatalabs::Identify.person(params: { name: 'sean thorne' })
 ```
 
-**Getting Company Data**
+**Using Company APIs**
 ```ruby
 # By Enrichment
 Peopledatalabs::Enrichment.company(params: { website: 'peopledatalabs.com' })
@@ -91,11 +93,14 @@ Peopledatalabs::Search.company(searchType: 'sql', query: "SELECT * FROM company
 Peopledatalabs::Search.company(searchType: 'elastic', query: {"query": "must": [{"term": {"tags": "big data"}}, {"term": {"industry": "financial services"}}, {"term": {"location_country": "united states"}}]})
 ```
 
-**Using Supporting APIs**
+**Using Autocomplete API**
 ```ruby
 # Get Autocomplete Suggestions
 Peopledatalabs::Autocomplete.retrieve(field: 'title', text: 'full', size: 10)
+```
 
+**Using Cleaner APIs**
+```ruby
 # Clean Raw Company Strings
 Peopledatalabs::Cleaner.company(kind: 'name', value: 'peOple DaTa LabS')
 
@@ -106,13 +111,31 @@ Peopledatalabs::Cleaner.location(value: '455 Market Street, San Francisco, Calif
 Peopledatalabs::Cleaner.school(kind: 'name', value: 'university of oregon')
 ```
 
+**Using Job Title Enrichment API**
+```ruby
+# Get Job Title Enrichment
+Peopledatalabs::JobTitle.retrieve(job_title: 'data scientist')
+```
+
+**Using Skill Enrichment API**
+```ruby
+# Get Skill Enrichment
+Peopledatalabs::Skill.retrieve(skill: 'c++')
+```
+
+## 🏝 Sandbox Usage <a name="sandbox"></a>
+```ruby
+# To enable sandbox usage, use the following flag
+Peopledatalabs.sandbox = true
+```
+
 ## 🌐 Endpoints <a name="endpoints"></a>
 
 **Person Endpoints**
 | API Endpoint | peopledatalabs Function |
 |-|-|
 | [Person Enrichment API](https://docs.peopledatalabs.com/docs/enrichment-api) | `Peopledatalabs::Enrichment.person(...params)` |
-| [Person Bulk Person Enrichment API](https://docs.peopledatalabs.com/docs/bulk-enrichment-api) | `Peopledatalabs::Bulk.people(...records)` |
+| [Person Bulk Person Enrichment API](https://docs.peopledatalabs.com/docs/bulk-enrichment-api) | `Peopledatalabs::Bulk.person(...records)` |
 | [Person Search API](https://docs.peopledatalabs.com/docs/search-api) | `Peopledatalabs::Search.person(...params)` |
 | [Person Retrieve API](https://docs.peopledatalabs.com/docs/person-retrieve-api) | `Peopledatalabs::Autocomplete.retrieve(...params)` |
 | [Person Identify API](https://docs.peopledatalabs.com/docs/identify-api) | `Peopledatalabs::Identify.person(...params)` |
@@ -130,7 +153,8 @@ Peopledatalabs::Cleaner.school(kind: 'name', value: 'university of oregon')
 | [Company Cleaner API](https://docs.peopledatalabs.com/docs/cleaner-apis#companyclean) | `Peopledatalabs::Cleaner.company(...params)` |
 | [Location Cleaner API](https://docs.peopledatalabs.com/docs/cleaner-apis#locationclean) | `Peopledatalabs::Cleaner.location(...params)` |
 | [School Cleaner API](https://docs.peopledatalabs.com/docs/cleaner-apis#schoolclean) | `Peopledatalabs::Cleaner.school(...params)` |
-
+| [Job Title Enrichment API](https://docs.peopledatalabs.com/docs/job-title-enrichment-api) | `Peopledatalabs::JobTitle.retrieve(...params)` |
+| [Skill Enrichment API](https://docs.peopledatalabs.com/docs/skill-enrichment-api) | `Peopledatalabs::Skill.retrieve(...params)` |
 
 ## 📘 Documentation <a name="documentation"></a>
 
@@ -151,3 +175,10 @@ Conversely, this would be **invalid** because `fake_parameter` is not an input p
 ```ruby
 Peopledatalabs::Identify.person(params: { fake_parameter: 'anything' })
 ```
+
+## ⚠️ Upgrading from v1.X.X to v2.0.0 <a name="upgrading"></a>
+
+Bulk Person and Person Search now use .person instead of .people
+
+i.e. Peopledatalabs::Bulk.people(...records) is now Peopledatalabs::Bulk.person(...records)
+<br />i.e. Peopledatalabs::Search.people(...params) is now Peopledatalabs::Search.person(...params)

data/lib/peopledatalabs/api_resource.rb

@@ -81,6 +81,16 @@ module Peopledatalabs
         elsif (!VALID_AUTOCOMPLETE_FIELDS.include?(field))
           result = { 'status' => 400, 'message' => "Field should be one of: #{VALID_AUTOCOMPLETE_FIELDS.join(', ')}" }
         end
+      elsif path.include? '/job_title'
+        field = params['job_title']
+        if (!field)
+          result = { 'status' => 400, 'message' => 'Missing job_title' }
+        end
+      elsif path.include? '/skill'
+        field = params['skill']
+        if (!field)
+          result = { 'status' => 400, 'message' => 'Missing skill' }
+        end
       end
       result
     end
@@ -99,15 +109,27 @@ module Peopledatalabs
       #   'data' => response.parse
       # }
 
+      rate_limit_remaining = response.headers['X-RateLimit-Remaining'] ? JSON.parse(response.headers['X-RateLimit-Remaining'].gsub("'",'"')) : {}
+      rate_limit_limit = response.headers['X-RateLimit-Limit'] ? JSON.parse(response.headers['X-RateLimit-Limit'].gsub("'",'"')) : {}
+
       rate_limit = {
-        'retry_after' => to_number(response.headers['Retry-After']),
-        'rate_limit' => to_number(response.headers['X-RateLimit-Limit']),
-        'rateLimit_reset' => to_number(response.headers['X-RateLimit-Reset']),
-        'total_limit' => to_number(response.headers['X-TotalLimit-Limit']),
-        'total_limit_remaining' => to_number(response.headers['X-RateLimit-Remaining']),
-        'search_limit_remaining' => to_number(response.headers['X-SearchLimit-Remaining']),
-        'enrich_company_limit_remaining' => to_number(response.headers['X-EnrichCompanyLimit-Remaining']),
-        'person_identify_limit_remaining' => to_number(response.headers['X-PersonIdentifyLimit-Remaining'])
+        'call_credits_spent' => to_number(response.headers['X-Call-Credits-Spent']),
+        'call_credits_type' => response.headers['X-Call-Credits-Type'],
+        'rate_limit_reset' => response.headers['X-RateLimit-Reset'],
+        'rate_limit_remaining' => {
+          'minute' => to_number(rate_limit_remaining['minute']),
+          'day' => to_number(rate_limit_remaining['day']),
+          'month' => to_number(rate_limit_remaining['month'])
+        },
+        'rate_limit_limit' => {
+          'minute' => to_number(rate_limit_limit['minute']),
+          'day' => to_number(rate_limit_limit['day']),
+          'month' => to_number(rate_limit_limit['month'])
+        },
+        'lifetime_used' => to_number(response.headers['X-Lifetime-Used']),
+        'total_limit_remaining' => to_number(response.headers['X-TotalLimit-Remaining']),
+        'total_limit_purchased_remaining' => to_number(response.headers['X-TotalLimit-Purchased-Remaining']),
+        'total_limit_overages_remaining' => to_number(response.headers['X-TotalLimit-Overages-Remaining'])
       }
 
       parsed_response = response.parse

data/lib/peopledatalabs/configuration.rb

@@ -3,7 +3,7 @@
 module Peopledatalabs
   class Configuration
     attr_accessor :api_key
-    attr_accessor :api_base
+    attr_accessor :sandbox
     attr_accessor :read_timeout
 
     def self.setup
@@ -13,10 +13,13 @@ module Peopledatalabs
     end
 
     def initialize
-      @api_base = "https://api.peopledatalabs.com"
       @read_timeout = 10
       @api_key ||= ENV['PDL_API_KEY']
+      @sanbox = false
     end
 
+    def api_base
+      sandbox ? 'https://sandbox.api.peopledatalabs.com' : 'https://api.peopledatalabs.com'
+    end
   end
 end

data/lib/peopledatalabs/resources/autocomplete.rb

@@ -11,7 +11,10 @@ module Peopledatalabs
         'pretty' => pretty,
       };
 
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: '/v5/autocomplete', headers: headers, params: params)
     end
   end

data/lib/peopledatalabs/resources/bulk.rb

@@ -2,8 +2,11 @@
 
 module Peopledatalabs
   class Bulk < APIResource
-    def self.people(params:)
-      headers = { 'Accept-Encoding' => 'gzip' }
+    def self.person(params:)
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       post(path: '/v5/person/bulk', headers: headers, body: params)
     end
   end

data/lib/peopledatalabs/resources/cleaner.rb

@@ -3,17 +3,26 @@
 module Peopledatalabs
   class Cleaner < APIResource
     def self.company(kind:, value:)
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: '/v5/company/clean', headers: headers, params: { kind => value })
     end
 
     def self.school(kind:, value:)
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: '/v5/school/clean', headers: headers, params: { kind => value })
     end
 
     def self.location(value:)
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: '/v5/location/clean', headers: headers, params: { 'location' => value })
     end
 

data/lib/peopledatalabs/resources/enrichment.rb

@@ -3,12 +3,18 @@
 module Peopledatalabs
   class Enrichment < APIResource
     def self.person(params:)
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: '/v5/person/enrich', headers: headers, params: params)
     end
 
     def self.company(params:)
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: '/v5/company/enrich', headers: headers, params: params)
     end
 

data/lib/peopledatalabs/resources/identify.rb

@@ -3,7 +3,10 @@
 module Peopledatalabs
   class Identify < APIResource
     def self.person(params:)
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: '/v5/person/identify', headers: headers, params: params)
     end
   end

data/lib/peopledatalabs/resources/jobtitle.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Peopledatalabs
+    class JobTitle < APIResource
+      def self.retrieve(job_title:, pretty: false)
+  
+        params = {
+          'job_title' => job_title,
+          'pretty' => pretty,
+        };
+  
+        headers = {
+          'Accept-Encoding' => 'gzip',
+          'User-Agent' => 'PDL-RUBY-SDK',
+        }
+        get(path: '/v5/job_title/enrich', headers: headers, params: params)
+      end
+    end
+  end
+  

data/lib/peopledatalabs/resources/retrieve.rb

@@ -3,7 +3,10 @@
 module Peopledatalabs
   class Retrieve < APIResource
     def self.person(person_id:, pretty: false)
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       get(path: "/v5/person/retrieve/#{person_id}", headers: headers, params: { 'pretty' => pretty })
     end
   end

data/lib/peopledatalabs/resources/search.rb

@@ -2,7 +2,7 @@
 
 module Peopledatalabs
   class Search < APIResource
-    def self.people(searchType:, query: , titlecase: false, dataset: 'all', size: 10, pretty: false, scroll_token: nil)
+    def self.person(searchType:, query: , titlecase: false, dataset: 'all', size: 10, pretty: false, scroll_token: nil)
       search(searchType: searchType,
              query: query,
              titlecase: titlecase,
@@ -33,7 +33,10 @@ module Peopledatalabs
         'scroll_token' => scroll_token
       }
 
-      headers = { 'Accept-Encoding' => 'gzip' }
+      headers = {
+        'Accept-Encoding' => 'gzip',
+        'User-Agent' => 'PDL-RUBY-SDK',
+      }
       post(path: "/v5/#{kind}/search", headers: headers, body: body)
     end
   end

data/lib/peopledatalabs/resources/skill.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Peopledatalabs
+    class Skill < APIResource
+      def self.retrieve(skill:, pretty: false)
+  
+        params = {
+          'skill' => skill,
+          'pretty' => pretty,
+        };
+  
+        headers = {
+          'Accept-Encoding' => 'gzip',
+          'User-Agent' => 'PDL-RUBY-SDK',
+        }
+        get(path: '/v5/skill/enrich', headers: headers, params: params)
+      end
+    end
+  end
+  

data/lib/peopledatalabs/version.rb

@@ -1,3 +1,3 @@
 module Peopledatalabs
-  VERSION = "1.0.2"
+  VERSION = "2.0.0"
 end

data/lib/peopledatalabs.rb

@@ -10,10 +10,12 @@ require 'peopledatalabs/resources/enrichment'
 require 'peopledatalabs/resources/identify'
 require 'peopledatalabs/resources/retrieve'
 require 'peopledatalabs/resources/bulk'
+require 'peopledatalabs/resources/jobtitle'
+require 'peopledatalabs/resources/skill'
 
 
 # gem build peopledatalabs.gemspec
-# gem install ./peopledatalabs-1.0.2.gem
+# gem install ./peopledatalabs-2.0.0.gem
 # irb
 # require 'peopledatalabs'
 # rake spec PDL_API_KEY=API_KEY
@@ -21,20 +23,24 @@ require 'peopledatalabs/resources/bulk'
 # Usage
 # First set api key
 # Peopledatalabs.api_key = 'api_key'
+# # Can set sandbox to true. Defaults to false
+# # Peopledatalabs.sandbox = false
 # Examples Calls:
 # Peopledatalabs::Cleaner.company(kind: 'website', value: 'peopledatalabs.com')
 # Peopledatalabs::Cleaner.school(kind: 'profile', value: 'linkedin.com/school/ucla')
 # Peopledatalabs::Cleaner.location(value: '239 NW 13th Ave, Portland, Oregon 97209, US')
-# Peopledatalabs::Search.people(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
-# Peopledatalabs::Search.people(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
+# Peopledatalabs::Search.person(searchType: 'elastic', query: {"query": {"term": {"job_company_name": "people data labs"}}})
+# Peopledatalabs::Search.person(searchType: 'sql', query: "SELECT * FROM person WHERE job_company_name='people data labs'")
 # Peopledatalabs::Autocomplete.retrieve(field: 'school', text: 'university of michigan')
 # Peopledatalabs::Enrichment.person(params: { name: 'Jennifer C. Jackson', locality: 'Boise' })
-# Peopledatalabs::Bulk.people(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
+# Peopledatalabs::Bulk.person(params: {requests: [{params: {profile: ['linkedin.com/in/seanthorne']}}, {params: {profile: ['linkedin.com/in/randrewn']}}]})
 # Peopledatalabs::Enrichment.company(params: { name: 'Google, Inc.', ticker: 'GOOGL'})
 # Peopledatalabs::Identify.person(params: { name: 'Jennifer C. Jackson', location: 'Medford, OR USA' })
 # Peopledatalabs::Retrieve.person(person_id: 'qEnOZ5Oh0poWnQ1luFBfVw_0000')
 # Peopledatalabs::Search.company(searchType: 'sql', size: 10, query: "SELECT * FROM company WHERE tags='big data' AND industry='financial services' AND location.country='united states';")
 # Peopledatalabs::Search.company(searchType: 'elastic', size: 10, query: { query: { bool: { must: [{term: {location_country: 'mexico'}}, {term: {job_title_role: 'health'}}, {exists: {field: 'phone_numbers'}}]}}})
+# Peopledatalabs::JobTitle.retrieve(job_title: 'data scientist')
+# Peopledatalabs::Skill.retrieve(skill: 'c++')
 
 module Peopledatalabs
   class Error < StandardError; end
@@ -47,8 +53,9 @@ module Peopledatalabs
     attr_reader :config
 
     def_delegators :@config, :api_key, :api_key=
-    def_delegators :@config, :api_base, :api_base=
+    def_delegators :@config, :sandbox, :sandbox=
     def_delegators :@config, :read_timeout, :read_timeout=
+    def_delegators :@config, :api_base
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: peopledatalabs
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 2.0.0
 platform: ruby
 authors:
 - People Data Labs
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-05-16 00:00:00.000000000 Z
+date: 2022-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -111,8 +111,10 @@ files:
 - lib/peopledatalabs/resources/cleaner.rb
 - lib/peopledatalabs/resources/enrichment.rb
 - lib/peopledatalabs/resources/identify.rb
+- lib/peopledatalabs/resources/jobtitle.rb
 - lib/peopledatalabs/resources/retrieve.rb
 - lib/peopledatalabs/resources/search.rb
+- lib/peopledatalabs/resources/skill.rb
 - lib/peopledatalabs/version.rb
 - peopledatalabs.gemspec
 homepage: https://www.peopledatalabs.com