cufinder-ruby 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 933505a753cc67ab4e2311cb44741da6ce2c89f186e2eaa36efad0adc2044a63
-  data.tar.gz: 8025f9c7eb01e26078c870967aba4d68af22ecab84242c93706279735620f555
+  metadata.gz: 44b98b86c620454eac62fab4ba87a4c2e49aaa710d4096825932e6294d037bd9
+  data.tar.gz: 574b9c457d9a3fbbbc0602617ba323ba7930499055b485ec162763185dce5305
 SHA512:
-  metadata.gz: dcde541a1672ea1b08e82dade2fa76f5c7c5a2aecc81dff9900875b7acd15794e58ffc8b3bbea0aca6e71cafb23e230bd097c767b9665cd6da1c6f78115ded29
-  data.tar.gz: 2c6b4ff7797fe5b818d57673fcd06c9c3ea810f909ff1598763424bdb281d85c79ca44933f40a123ca20f35fce8870d5cfcbe6e670e63d198b025312ee433203
+  metadata.gz: 2a786c6a1b6f151223eff85114283d736e24e93ee0e946b0eac1900a2b57952261ee7eccb947ca5129fc735ba636c5d259c2cd0ff21aa4a54597801db5bd48c1
+  data.tar.gz: 29967a91c181832949a7f9092d96507a3a4cad5bc140cfb5d262fdf2f2b0a0c203d109c790893593a2f22813b16381fcc7d22d125367f2e006db3115f55ae5cc

data/CHANGELOG.md

@@ -1,6 +1,15 @@
 # Cufinder Ruby SDK Changelog
 
 
+## 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 32 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,10 @@ 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)
 
 
 **CUF - Company Name to Domain**
@@ -279,7 +283,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 +292,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 +353,42 @@ 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
+```
+
 ## 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.2.0"
   spec.authors       = ["CUFinder Team"]
   spec.email         = ["support@cufinder.io"]
 

data/lib/cufinder_ruby/client.rb

@@ -141,5 +141,21 @@ 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
   end
 end

data/lib/cufinder_ruby/services.rb

@@ -228,6 +228,36 @@ 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
     
     private
     

data/lib/cufinder_ruby/types.rb

@@ -601,4 +601,146 @@ 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
 end

data/lib/cufinder_ruby/version.rb

@@ -1,3 +1,3 @@
 module Cufinder
-  VERSION = "1.1.0"
+  VERSION = "1.2.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.2.0
 platform: ruby
 authors:
 - CUFinder Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 2026-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty