cufinder-ruby 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44b98b86c620454eac62fab4ba87a4c2e49aaa710d4096825932e6294d037bd9
-  data.tar.gz: 574b9c457d9a3fbbbc0602617ba323ba7930499055b485ec162763185dce5305
+  metadata.gz: cc7f5e63b564fee6e9888b8bd083c59d0d68a706c30347e577ac5ca5c16156ae
+  data.tar.gz: 287db7dcf6eee9afe5accc262dbbc2bfaa12b3f66cac1579fa6241aba21674e0
 SHA512:
-  metadata.gz: 2a786c6a1b6f151223eff85114283d736e24e93ee0e946b0eac1900a2b57952261ee7eccb947ca5129fc735ba636c5d259c2cd0ff21aa4a54597801db5bd48c1
-  data.tar.gz: 29967a91c181832949a7f9092d96507a3a4cad5bc140cfb5d262fdf2f2b0a0c203d109c790893593a2f22813b16381fcc7d22d125367f2e006db3115f55ae5cc
+  metadata.gz: 9312069155fbf85312c434e7f7b5e1609146b4bbfe4953d19868b67a9ac4fb43471e47209125612dde3612d42050304531b0e3cd36e748dc6ba92b2e14f4116e
+  data.tar.gz: 705a265b7dd088a5baf4b228006f724e9b34d894906b9cf9605f983925aa1aa322ad3386157d45a43904085ba409a12ec9e2d28d92fc642663565b864d607264

data/CHANGELOG.md

@@ -1,6 +1,12 @@
 # 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

data/README.md

@@ -53,7 +53,7 @@ client = Cufinder::Client.new(
 
 ## API Reference
 
-This SDK covers all 32 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)
@@ -87,6 +87,14 @@ This SDK covers all 32 Cufinder API (v2) endpoints:
 - **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**
@@ -389,6 +397,86 @@ 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.2.0"
+  spec.version       = "1.3.0"
   spec.authors       = ["CUFinder Team"]
   spec.email         = ["support@cufinder.io"]
 

data/lib/cufinder_ruby/client.rb

@@ -157,5 +157,37 @@ module Cufinder
     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

@@ -258,6 +258,70 @@ module Cufinder
       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

@@ -743,4 +743,186 @@ module Cufinder
       @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.2.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.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - CUFinder Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-21 00:00:00.000000000 Z
+date: 2026-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty