cufinder-ruby 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 933505a753cc67ab4e2311cb44741da6ce2c89f186e2eaa36efad0adc2044a63
-  data.tar.gz: 8025f9c7eb01e26078c870967aba4d68af22ecab84242c93706279735620f555
+  metadata.gz: cc7f5e63b564fee6e9888b8bd083c59d0d68a706c30347e577ac5ca5c16156ae
+  data.tar.gz: 287db7dcf6eee9afe5accc262dbbc2bfaa12b3f66cac1579fa6241aba21674e0
 SHA512:
-  metadata.gz: dcde541a1672ea1b08e82dade2fa76f5c7c5a2aecc81dff9900875b7acd15794e58ffc8b3bbea0aca6e71cafb23e230bd097c767b9665cd6da1c6f78115ded29
-  data.tar.gz: 2c6b4ff7797fe5b818d57673fcd06c9c3ea810f909ff1598763424bdb281d85c79ca44933f40a123ca20f35fce8870d5cfcbe6e670e63d198b025312ee433203
+  metadata.gz: 9312069155fbf85312c434e7f7b5e1609146b4bbfe4953d19868b67a9ac4fb43471e47209125612dde3612d42050304531b0e3cd36e748dc6ba92b2e14f4116e
+  data.tar.gz: 705a265b7dd088a5baf4b228006f724e9b34d894906b9cf9605f983925aa1aa322ad3386157d45a43904085ba409a12ec9e2d28d92fc642663565b864d607264

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 # Cufinder Ruby SDK Changelog
 
 
+## 1.3.0 (August 16, 2026)
+
+#### Features
+- **New V2 API services**: Add new V2 services including `PSA`, `CSA`, `JCA`, `CLF`, `NAP`, `NAU`, `GDC` and `COT`
+
+
+## 1.2.0 (June 21, 2026)
+
+#### Features
+- **New V2 API services**: Add new V2 services including `CEF`, `NAC`, `CAA` and `CJA`
+
+
+
+
+
 ## 1.1.0 (February 01, 2026)
 
 #### Features

data/README.md

@@ -53,7 +53,7 @@ client = Cufinder::Client.new(
 
 ## API Reference
 
-This SDK covers all 28 Cufinder API (v2) endpoints:
+This SDK covers all 40 Cufinder API (v2) endpoints:
 
 - **CUF** - [Company Name to Domain](https://apidoc.cufinder.io/apis/company-name-to-domain)
 - **LCUF** - [LinkedIn Company URL Finder](https://apidoc.cufinder.io/apis/company-linkedin-url-finder)
@@ -83,6 +83,18 @@ This SDK covers all 28 Cufinder API (v2) endpoints:
 - **CSN** - [Company Snapshot](https://apidoc.cufinder.io/apis/company-snapshot)
 - **NAO** - [Phone Number Normalizer](https://apidoc.cufinder.io/apis/phone-number-normalizer)
 - **NAA** - [Address Normalizer](https://apidoc.cufinder.io/apis/address-normalizer)
+- **CEF** - [Company Employees Finder](https://apidoc.cufinder.io/apis/company-employees-finder)
+- **NAC** - [Company Name Normalizer](https://apidoc.cufinder.io/apis/company-name-normalizer)
+- **CAA** - [Company Activities API](https://apidoc.cufinder.io/apis/company-activities-api)
+- **CJA** - [Company Jobs API](https://apidoc.cufinder.io/apis/company-jobs-api)
+- **PSA** - [Contact Signals API](https://apidoc.cufinder.io/apis/contact-signals-api)
+- **CSA** - [Company Signals API](https://apidoc.cufinder.io/apis/company-signals-api)
+- **JCA** - [Job Changes API](https://apidoc.cufinder.io/apis/job-changes-api)
+- **CLF** - [Contact Lookalikes API](https://apidoc.cufinder.io/apis/contact-lookalikes-api)
+- **NAP** - [Person Name Normalizer](https://apidoc.cufinder.io/apis/person-name-normalizer)
+- **NAU** - [URL Normalizer](https://apidoc.cufinder.io/apis/url-normalizer)
+- **GDC** - [Gives Demo Checker](https://apidoc.cufinder.io/apis/gives-demo-checker)
+- **COT** - [Offers Free Trial Checker](https://apidoc.cufinder.io/apis/offers-free-trial-checker)
 
 
 **CUF - Company Name to Domain**
@@ -279,7 +291,7 @@ puts result
 
 **BCD - B2B Customers Finder**
 
-Returns company's careers page
+Returns B2B customers for a company
 
 ```ruby
 result = client.bcd(url: "stripe.com")
@@ -288,7 +300,7 @@ puts result
 
 **CCP - Company Career Page Finder**
 
-Returns is company SaaS or not
+Returns company's careers page URL
 
 ```ruby
 result = client.ccp(url: "stripe.com")
@@ -349,6 +361,122 @@ result = client.naa(address: "1095 avenue of the Americas, 6th Avenue ny 10036")
 puts result
 ```
 
+**CEF - Company Employees Finder**
+
+Returns company's employees
+
+```ruby
+result = client.cef(query: "cufinder", page: 1)
+puts result
+```
+
+**NAC - Company Name Normalizer**
+
+Returns normalized company name
+
+```ruby
+result = client.nac(company: "cufinder inc.")
+puts result
+```
+
+**CAA - Company Activities API**
+
+Returns company's LinkedIn activities
+
+```ruby
+result = client.caa(query: "cufinder", page: 1)
+puts result
+```
+
+**CJA - Company Jobs API**
+
+Returns company's job listings
+
+```ruby
+result = client.cja(name: "google", country: "united states", page: 1)
+puts result
+```
+
+**PSA - Contact Signals API**
+
+Returns contacts based on company signals
+
+```ruby
+result = client.psa(signal_name: "employee_growth", time_frame: 90, bucket: "high", page: 1)
+result.contacts.each do |contact|
+  puts "#{contact.full_name} - #{contact.company['name']}"
+end
+```
+
+**CSA - Company Signals API**
+
+Returns companies based on signals
+
+```ruby
+result = client.csa(signal_name: "employee_growth", time_frame: 90, bucket: "high", page: 1)
+result.companies.each do |company|
+  puts "#{company.name} - #{company.domain}"
+end
+```
+
+**JCA - Job Changes API**
+
+Returns job changes within a date range
+
+```ruby
+result = client.jca(start_date: "2026-01-01", end_date: "2026-08-16", type: "promotion")
+result.job_changes.each do |change|
+  puts "#{change.type}: #{change.from.title} -> #{change.to.title}"
+end
+```
+
+**CLF - Contact Lookalikes API**
+
+Returns similar contacts based on a query
+
+```ruby
+result = client.clf(query: "linkedin.com/in/mortezaheydari1997")
+result.profiles.each do |profile|
+  puts "#{profile.full_name} - #{profile.company_name}"
+end
+```
+
+**NAP - Person Name Normalizer**
+
+Normalizes a person name
+
+```ruby
+result = client.nap(person_name: "morteza heydari")
+puts result.normalized_name
+```
+
+**NAU - URL Normalizer**
+
+Normalizes a URL
+
+```ruby
+result = client.nau(url: "https://www.cufinder.io/about-us")
+puts result.normalized_url
+```
+
+**GDC - Gives Demo Checker**
+
+Checks if a company offers demos
+
+```ruby
+result = client.gdc(url: "https://www.stripe.com")
+puts result.offers_demo
+```
+
+**COT - Offers Free Trial Checker**
+
+Checks if a company offers a free trial
+
+```ruby
+result = client.cot(url: "https://www.stripe.com")
+puts result.offers_free_trial
+```
+
 ## Error Handling
 
 The SDK provides comprehensive error handling with custom error types:

data/cufinder-ruby.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "cufinder-ruby"
-  spec.version       = "1.1.0"
+  spec.version       = "1.3.0"
   spec.authors       = ["CUFinder Team"]
   spec.email         = ["support@cufinder.io"]
 

data/lib/cufinder_ruby/client.rb

@@ -141,5 +141,53 @@ module Cufinder
     def naa(address:)
       @services.normalize_address(address: address)
     end
+
+    def cef(query:, page:)
+      @services.find_company_employees(query: query, page: page)
+    end
+
+    def nac(company:)
+      @services.normalize_company_name(company: company)
+    end
+
+    def caa(query:, page:)
+      @services.get_company_activities(query: query, page: page)
+    end
+
+    def cja(**params)
+      @services.search_company_jobs(params)
+    end
+
+    def psa(**params)
+      @services.get_contact_signals(params)
+    end
+
+    def csa(**params)
+      @services.get_company_signals(params)
+    end
+
+    def jca(**params)
+      @services.get_job_changes(params)
+    end
+
+    def clf(**params)
+      @services.find_contact_lookalikes(params)
+    end
+
+    def nap(**params)
+      @services.normalize_person_name(params)
+    end
+
+    def nau(**params)
+      @services.normalize_url(params)
+    end
+
+    def gdc(**params)
+      @services.gives_demo(params)
+    end
+
+    def cot(**params)
+      @services.offers_free_trial(params)
+    end
   end
 end

data/lib/cufinder_ruby/services.rb

@@ -228,6 +228,100 @@ module Cufinder
       response = @client.post("/naa", params)
       NaaResponse.new(response)
     end
+
+    # CEF Service - Company Employees Finder
+    def find_company_employees(params)
+      validate_required(params, [:query, :page])
+      
+      response = @client.post("/cef", params)
+      CefResponse.new(response)
+    end
+
+    # NAC Service - Company Name Normalizer
+    def normalize_company_name(params)
+      validate_required(params, [:company])
+      
+      response = @client.post("/nac", params)
+      NacResponse.new(response)
+    end
+
+    # CAA Service - Company Activities API
+    def get_company_activities(params)
+      validate_required(params, [:query, :page])
+      
+      response = @client.post("/caa", params)
+      CaaResponse.new(response)
+    end
+
+    # CJA Service - Company Jobs API
+    def search_company_jobs(params)
+      response = @client.post("/cja", params)
+      CjaResponse.new(response)
+    end
+
+    # PSA Service - Contact Signals API
+    def get_contact_signals(params)
+      validate_required(params, [:signal_name, :time_frame, :bucket])
+      
+      response = @client.post("/psa", params)
+      PsaResponse.new(response)
+    end
+
+    # CSA Service - Company Signals API
+    def get_company_signals(params)
+      validate_required(params, [:signal_name, :time_frame, :bucket])
+      
+      response = @client.post("/csa", params)
+      CsaResponse.new(response)
+    end
+
+    # JCA Service - Job Changes API
+    def get_job_changes(params)
+      validate_required(params, [:start_date, :end_date])
+      
+      response = @client.post("/jca", params)
+      JcaResponse.new(response)
+    end
+
+    # CLF Service - Contact Lookalikes API
+    def find_contact_lookalikes(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/clf", params)
+      ClfResponse.new(response)
+    end
+
+    # NAP Service - Person Name Normalizer
+    def normalize_person_name(params)
+      validate_required(params, [:person_name])
+      
+      response = @client.post("/nap", params)
+      NapResponse.new(response)
+    end
+
+    # NAU Service - URL Normalizer
+    def normalize_url(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/nau", params)
+      NauResponse.new(response)
+    end
+
+    # GDC Service - Gives Demo Checker
+    def gives_demo(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/gdc", params)
+      GdcResponse.new(response)
+    end
+
+    # COT Service - Offers Free Trial Checker
+    def offers_free_trial(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/cot", params)
+      CotResponse.new(response)
+    end
     
     private
     

data/lib/cufinder_ruby/types.rb

@@ -601,4 +601,328 @@ module Cufinder
       @address = data["address"]
     end
   end
+
+  # CEF Employee
+  class CefEmployee
+    attr_accessor :full_name, :first_name, :last_name, :linkedin_url, :summary,
+                  :avatar, :country, :state, :city, :job_title,
+                  :job_title_categories, :company_name, :company_linkedin,
+                  :company_website, :company_size, :company_industry,
+                  :company_facebook, :company_twitter, :company_country,
+                  :company_state, :company_city
+    
+    def initialize(data = {})
+      @full_name = data["full_name"]
+      @first_name = data["first_name"]
+      @last_name = data["last_name"]
+      @linkedin_url = data["linkedin_url"]
+      @summary = data["summary"]
+      @avatar = data["avatar"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @job_title = data["job_title"]
+      @job_title_categories = data["job_title_categories"]
+      @company_name = data["company_name"]
+      @company_linkedin = data["company_linkedin"]
+      @company_website = data["company_website"]
+      @company_size = data["company_size"]
+      @company_industry = data["company_industry"]
+      @company_facebook = data["company_facebook"]
+      @company_twitter = data["company_twitter"]
+      @company_country = data["company_country"]
+      @company_state = data["company_state"]
+      @company_city = data["company_city"]
+    end
+  end
+
+  class CefResponse < BaseResponse
+    attr_accessor :employees
+    
+    def initialize(data = {})
+      super(data)
+      @employees = (data["employees"] || []).map { |e| CefEmployee.new(e) }
+    end
+  end
+
+  class NacResponse < BaseResponse
+    attr_accessor :company
+    
+    def initialize(data = {})
+      super(data)
+      @company = data["company"]
+    end
+  end
+
+  # CAA Activity
+  class CaaActivity
+    attr_accessor :activity_url, :activity_id, :author_name, :author_type, :author_url,
+                  :activity_comments_count, :activity_hashtags, :activity_headline,
+                  :activity_images, :activity_is_video, :activity_posted_at,
+                  :activity_reactions_count, :activity_reposts_count, :activity_text,
+                  :activity_top_comments, :activity_videos
+    
+    def initialize(data = {})
+      @activity_url = data["activity_url"]
+      @activity_id = data["activity_id"]
+      @author_name = data["author_name"]
+      @author_type = data["author_type"]
+      @author_url = data["author_url"]
+      @activity_comments_count = data["activity_comments_count"]
+      @activity_hashtags = data["activity_hashtags"] || []
+      @activity_headline = data["activity_headline"]
+      @activity_images = data["activity_images"] || []
+      @activity_is_video = data["activity_is_video"]
+      @activity_posted_at = data["activity_posted_at"]
+      @activity_reactions_count = data["activity_reactions_count"]
+      @activity_reposts_count = data["activity_reposts_count"]
+      @activity_text = data["activity_text"]
+      @activity_top_comments = data["activity_top_comments"] || []
+      @activity_videos = data["activity_videos"] || []
+    end
+  end
+
+  class CaaResponse < BaseResponse
+    attr_accessor :activities
+    
+    def initialize(data = {})
+      super(data)
+      @activities = (data["activities"] || []).map { |a| CaaActivity.new(a) }
+    end
+  end
+
+  # CJA Company (within job listing)
+  class CjaCompany
+    attr_accessor :name, :industry, :website, :linkedin, :followers_count,
+                  :employees, :founded_date, :annual_revenue, :funding_amount,
+                  :main_location
+    
+    def initialize(data = {})
+      @name = data["name"]
+      @industry = data["industry"]
+      @website = data["website"]
+      @linkedin = data["linkedin"]
+      @followers_count = data["followers_count"]
+      @employees = data["employees"]
+      @founded_date = data["founded_date"]
+      @annual_revenue = data["annual_revenue"]
+      @funding_amount = data["funding_amount"]
+      @main_location = data["main_location"] ? MainLocation.new(data["main_location"]) : nil
+    end
+  end
+
+  # CJA Job listing
+  class CjaJob
+    attr_accessor :job_id, :title, :url, :location, :posted_at, :posted_at_text
+    
+    def initialize(data = {})
+      @job_id = data["job_id"]
+      @title = data["title"]
+      @url = data["url"]
+      @location = data["location"]
+      @posted_at = data["posted_at"]
+      @posted_at_text = data["posted_at_text"]
+    end
+  end
+
+  # CJA Company Job (combined company + job)
+  class CompanyJob
+    attr_accessor :company, :job
+    
+    def initialize(data = {})
+      @company = data["company"] ? CjaCompany.new(data["company"]) : nil
+      @job = data["job"] ? CjaJob.new(data["job"]) : nil
+    end
+  end
+
+  class CjaResponse < BaseResponse
+    attr_accessor :jobs
+    
+    def initialize(data = {})
+      super(data)
+      @jobs = (data["jobs"] || []).map { |j| CompanyJob.new(j) }
+    end
+  end
+
+  # Signal model
+  class Signal
+    attr_accessor :name, :time_frame, :bucket
+
+    def initialize(data = {})
+      @name = data["name"]
+      @time_frame = data["time_frame"]
+      @bucket = data["bucket"]
+    end
+  end
+
+  # PSA Contact Signal
+  class ContactSignal
+    attr_accessor :full_name, :current_job, :company, :location, :social, :signal
+
+    def initialize(data = {})
+      @full_name = data["full_name"]
+      @current_job = data["current_job"]
+      @company = data["company"]
+      @location = data["location"]
+      @social = data["social"]
+      @signal = data["signal"] ? Signal.new(data["signal"]) : nil
+    end
+  end
+
+  class PsaResponse < BaseResponse
+    attr_accessor :contacts
+
+    def initialize(data = {})
+      super(data)
+      @contacts = (data["contacts"] || []).map { |c| ContactSignal.new(c) }
+    end
+  end
+
+  # CSA Company Signal
+  class CompanySignal
+    attr_accessor :name, :website, :domain, :employees, :industry, :overview,
+                  :type, :main_location, :social, :signal
+
+    def initialize(data = {})
+      @name = data["name"]
+      @website = data["website"]
+      @domain = data["domain"]
+      @employees = data["employees"]
+      @industry = data["industry"]
+      @overview = data["overview"]
+      @type = data["type"]
+      @main_location = data["main_location"] ? MainLocation.new(data["main_location"]) : nil
+      @social = data["social"]
+      @signal = data["signal"] ? Signal.new(data["signal"]) : nil
+    end
+  end
+
+  class CsaResponse < BaseResponse
+    attr_accessor :companies
+
+    def initialize(data = {})
+      super(data)
+      @companies = (data["companies"] || []).map { |c| CompanySignal.new(c) }
+    end
+  end
+
+  # JCA Job Change company snapshot
+  class JobChangeCompanySnapshot
+    attr_accessor :company_linkedin_url, :company_linkedin_id, :company_name, :title
+
+    def initialize(data = {})
+      @company_linkedin_url = data["company_linkedin_url"]
+      @company_linkedin_id = data["company_linkedin_id"]
+      @company_name = data["company_name"]
+      @title = data["title"]
+    end
+  end
+
+  # JCA Job Change
+  class JobChange
+    attr_accessor :type, :linkedin_url, :detected_at, :from, :to
+
+    def initialize(data = {})
+      @type = data["type"]
+      @linkedin_url = data["linkedin_url"]
+      @detected_at = data["detected_at"]
+      @from = data["from"] ? JobChangeCompanySnapshot.new(data["from"]) : nil
+      @to = data["to"] ? JobChangeCompanySnapshot.new(data["to"]) : nil
+    end
+  end
+
+  class JcaResponse < BaseResponse
+    attr_accessor :job_changes
+
+    def initialize(data = {})
+      super(data)
+      @job_changes = (data["job_changes"] || []).map { |j| JobChange.new(j) }
+    end
+  end
+
+  # CLF Contact Lookalike profile
+  class ClfProfile
+    attr_accessor :first_name, :last_name, :full_name, :linkedin_url, :summary,
+                  :followers_count, :facebook, :twitter, :avatar, :country, :state,
+                  :city, :job_title, :job_title_categories, :company_name,
+                  :company_linkedin, :company_website, :company_size,
+                  :company_industry, :company_facebook, :company_twitter,
+                  :company_country, :company_state, :company_city
+
+    def initialize(data = {})
+      @first_name = data["first_name"]
+      @last_name = data["last_name"]
+      @full_name = data["full_name"]
+      @linkedin_url = data["linkedin_url"]
+      @summary = data["summary"]
+      @followers_count = data["followers_count"]
+      @facebook = data["facebook"]
+      @twitter = data["twitter"]
+      @avatar = data["avatar"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @job_title = data["job_title"]
+      @job_title_categories = data["job_title_categories"]
+      @company_name = data["company_name"]
+      @company_linkedin = data["company_linkedin"]
+      @company_website = data["company_website"]
+      @company_size = data["company_size"]
+      @company_industry = data["company_industry"]
+      @company_facebook = data["company_facebook"]
+      @company_twitter = data["company_twitter"]
+      @company_country = data["company_country"]
+      @company_state = data["company_state"]
+      @company_city = data["company_city"]
+    end
+  end
+
+  class ClfResponse < BaseResponse
+    attr_accessor :profiles
+
+    def initialize(data = {})
+      super(data)
+      @profiles = (data["profiles"] || []).map { |p| ClfProfile.new(p) }
+    end
+  end
+
+  # NAP - Person Name Normalizer
+  class NapResponse < BaseResponse
+    attr_accessor :normalized_name
+
+    def initialize(data = {})
+      super(data)
+      @normalized_name = data["normalized_name"]
+    end
+  end
+
+  # NAU - URL Normalizer
+  class NauResponse < BaseResponse
+    attr_accessor :normalized_url
+
+    def initialize(data = {})
+      super(data)
+      @normalized_url = data["normalized_url"]
+    end
+  end
+
+  # GDC - Gives Demo Checker
+  class GdcResponse < BaseResponse
+    attr_accessor :offers_demo
+
+    def initialize(data = {})
+      super(data)
+      @offers_demo = data["offers_demo"]
+    end
+  end
+
+  # COT - Offers Free Trial Checker
+  class CotResponse < BaseResponse
+    attr_accessor :offers_free_trial
+
+    def initialize(data = {})
+      super(data)
+      @offers_free_trial = data["offers_free_trial"]
+    end
+  end
 end

data/lib/cufinder_ruby/version.rb

@@ -1,3 +1,3 @@
 module Cufinder
-  VERSION = "1.1.0"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cufinder-ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - CUFinder Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 2026-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty