cufinder-ruby 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f02342f587a60dcb5946f69fce0aab002736425ead7614d5cecaca4af35d035
-  data.tar.gz: '097b09d59e662d36c221de3fcc9bda06ebc0778c84daf291fb12f7047dd3f549'
+  metadata.gz: 44b98b86c620454eac62fab4ba87a4c2e49aaa710d4096825932e6294d037bd9
+  data.tar.gz: 574b9c457d9a3fbbbc0602617ba323ba7930499055b485ec162763185dce5305
 SHA512:
-  metadata.gz: bc1ee47853ec78af1f478410b7ed54dc0dcb024d918cf0f32e145084f621751326a4f878b7ff4ec22029f39efcccb5b1e4fa0b386a42ae8bd2cc5aa937f85df4
-  data.tar.gz: 469e8cd28fc6308b2768ffcda28a350397604908ae3ebfedc531b24c76e8a067be905f0deddad258894825f4155acd7554d131d1637cf9ee6393d1b3514ec0a7
+  metadata.gz: 2a786c6a1b6f151223eff85114283d736e24e93ee0e946b0eac1900a2b57952261ee7eccb947ca5129fc735ba636c5d259c2cd0ff21aa4a54597801db5bd48c1
+  data.tar.gz: 29967a91c181832949a7f9092d96507a3a4cad5bc140cfb5d262fdf2f2b0a0c203d109c790893593a2f22813b16381fcc7d22d125367f2e006db3115f55ae5cc

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# 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
+- **New V2 API services**: Add new V2 services including `BCD`, `CCP`, `ISC`, `CBC`, `CSC`, `CSN`, `NAO` and `NAA`
+
+
+#### Documentation
+- **Updated README.md**: Add API reference for all new services

data/README.md

@@ -1,6 +1,19 @@
-# CUFinder Ruby Client
+# CUFinder Ruby SDK
 
-Official Ruby Client for accessing CUFinder's comprehensive business intelligence and lead generation services.
+[![](https://img.shields.io/badge/repo%20status-Active-28a745)](https://github.com/cufinder/cufinder-ruby)
+[![License: MIT](https://img.shields.io/badge/License-MIT-514BEE.svg)](https://opensource.org/licenses/MIT)
+[![Gem Version](https://img.shields.io/gem/v/cufinder-ruby.svg)](https://rubygems.org/gems/cufinder-ruby)
+
+A Ruby SDK for the CUFinder API that provides access to all company and person enrichment services.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [API Reference](#api-reference)
+- [Error Handling](#error-handling)
+- [Types](#types)
+- [Support](#support)
 
 ## Installation
 
@@ -24,168 +37,479 @@ gem install cufinder-ruby
 
 ## Usage
 
-### Basic Setup
-
 ```ruby
 require 'cufinder_ruby'
 
-# Initialize the client with your API key
+# Initialize the client
 client = Cufinder::Client.new(api_key: 'your-api-key-here')
+
+# Initialize with more options
+client = Cufinder::Client.new(
+  api_key: 'your-api-key-here',
+  timeout: 60,
+  max_retries: 3
+)
+```
+
+## API Reference
+
+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)
+- **DTC** - [Domain to Company Name](https://apidoc.cufinder.io/apis/domain-to-company-name)
+- **DTE** - [Company Email Finder](https://apidoc.cufinder.io/apis/company-email-finder)
+- **NTP** - [Company Phone Finder](https://apidoc.cufinder.io/apis/company-phone-finder)
+- **REL** - [Reverse Email Lookup](https://apidoc.cufinder.io/apis/reverse-email-lookup)
+- **FCL** - [Company Lookalikes Finder](https://apidoc.cufinder.io/apis/company-lookalikes-finder)
+- **ELF** - [Company Fundraising](https://apidoc.cufinder.io/apis/company-fundraising)
+- **CAR** - [Company Revenue Finder](https://apidoc.cufinder.io/apis/company-revenue-finder)
+- **FCC** - [Company Subsidiaries Finder](https://apidoc.cufinder.io/apis/company-subsidiaries-finder)
+- **FTS** - [Company Tech Stack Finder](https://apidoc.cufinder.io/apis/company-tech-stack-finder)
+- **EPP** - [LinkedIn Profile Enrichment](https://apidoc.cufinder.io/apis/linkedin-profile-enrichment)
+- **FWE** - [LinkedIn Profile Email Finder](https://apidoc.cufinder.io/apis/linkedin-profile-email-finder)
+- **TEP** - [Person Enrichment](https://apidoc.cufinder.io/apis/person-enrichment)
+- **ENC** - [Company Enrichment](https://apidoc.cufinder.io/apis/company-enrichment)
+- **CEC** - [Company Employee Count](https://apidoc.cufinder.io/apis/company-employee-count)
+- **CLO** - [Company Locations](https://apidoc.cufinder.io/apis/company-locations)
+- **CSE** - [Company Search](https://apidoc.cufinder.io/apis/company-search)
+- **PSE** - [Person Search](https://apidoc.cufinder.io/apis/person-search)
+- **LBS** - [Local Business Search (Google Maps Search API)](https://apidoc.cufinder.io/apis/local-business-search-google-maps-search-api)
+- **BCD** - [B2B Customers Finder](https://apidoc.cufinder.io/apis/b2b-customers-finder)
+- **CCP** - [Company Career Page Finder](https://apidoc.cufinder.io/apis/company-career-page-finder)
+- **ISC** - [Company Saas Checker](https://apidoc.cufinder.io/apis/company-saas-checker)
+- **CBC** - [Company B2B or B2C Checker](https://apidoc.cufinder.io/apis/company-b2b-or-b2c-checker)
+- **CSC** - [Company Mission Statement](https://apidoc.cufinder.io/apis/company-mission-statement)
+- **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**
+
+Returns the official website URL of a company based on its name.
+
+```ruby
+result = client.cuf(company_name: 'cufinder', country_code: 'US')
+puts result
+```
+
+**LCUF - LinkedIn Company URL Finder**
+
+Finds the official LinkedIn company profile URL from a company name.
+
+```ruby
+result = client.lcuf(company_name: 'cufinder')
+puts result
+```
+
+**DTC - Domain to Company Name**
+
+Retrieves the registered company name associated with a given website domain.
+
+```ruby
+result = client.dtc(company_website: 'cufinder.io')
+puts result
+```
+
+**DTE - Company Email Finder**
+
+Returns up to five general or role-based business email addresses for a company.
+
+```ruby
+result = client.dte(company_website: 'cufinder.io')
+puts result
+```
+
+**NTP - Company Phone Finder**
+
+Returns up to two verified phone numbers for a company.
+
+```ruby
+result = client.ntp(company_name: 'apple')
+puts result
+```
+
+**REL - Reverse Email Lookup**
+
+Enriches an email address with detailed person and company information.
+
+```ruby
+result = client.rel(email: 'iain.mckenzie@stripe.com')
+puts result
+```
+
+**FCL - Company Lookalikes Finder**
+
+Provides a list of similar companies based on an input company's profile.
+
+```ruby
+result = client.fcl(query: 'apple')
+puts result
+```
+
+**ELF - Company Fundraising**
+
+Returns detailed funding information about a company.
+
+```ruby
+result = client.elf(query: 'cufinder')
+puts result
+```
+
+**CAR - Company Revenue Finder**
+
+Estimates a company's annual revenue based on name.
+
+```ruby
+result = client.car(query: 'apple')
+puts result
+```
+
+**FCC - Company Subsidiaries Finder**
+
+Identifies known subsidiaries of a parent company.
+
+```ruby
+result = client.fcc(query: 'amazon')
+puts result
 ```
 
-### Available Services
+**FTS - Company Tech Stack Finder**
 
-The Client provides access to all CUFinder API services:
+Detects the technologies a company uses.
 
-#### 1. CUF - Company URL Finder
 ```ruby
-result = client.cuf(company_name: "Apple Inc", country_code: "US")
-puts result.domain  # => "apple.com"
+result = client.fts(query: 'cufinder')
+puts result
 ```
 
-#### 2. LCUF - LinkedIn Company URL Finder
+**EPP - LinkedIn Profile Enrichment**
+
+Takes a LinkedIn profile URL and returns enriched person and company data.
+
 ```ruby
-result = client.lcuf(company_name: "Apple Inc")
-puts result.linkedin_url  # => "linkedin.com/company/apple"
+result = client.epp(linkedin_url: 'linkedin.com/in/iain-mckenzie')
+puts result
 ```
 
-#### 3. DTC - Domain to Company
+**FWE - LinkedIn Profile Email Finder**
+
+Extracts a verified business email address from a LinkedIn profile URL.
+
+```ruby
+result = client.fwe(linkedin_url: 'linkedin.com/in/iain-mckenzie')
+puts result
+```
+
+**TEP - Person Enrichment**
+
+Returns enriched person data based on full name and company name.
+
+```ruby
+result = client.tep(full_name: 'iain mckenzie', company: 'stripe')
+puts result
+```
+
+**ENC - Company Enrichment**
+
+Provides a complete company profile from a company name.
+
 ```ruby
-result = client.dtc(company_website: "apple.com")
-puts result.company_name  # => "Apple Inc"
+result = client.enc(query: 'cufinder')
+puts result
 ```
 
-#### 4. DTE - Domain to Emails
+**CEC - Company Employee Count**
+
+Returns an estimated number of employees for a company.
+
 ```ruby
-result = client.dte(company_website: "apple.com")
-puts result.emails  # => ["contact@apple.com", "info@apple.com"]
+result = client.cec(query: 'cufinder')
+puts result
 ```
 
-#### 5. NTP - Name to Phones
+**CLO - Company Locations**
+
+Returns the known physical office locations of a company.
+
 ```ruby
-result = client.ntp(company_name: "Apple Inc")
-puts result.phones  # => ["+1-408-996-1010"]
+result = client.clo(query: 'apple')
+puts result
 ```
 
-#### 6. REL - Reverse Email Lookup
+**CSE - Company Search**
+
+Search for companies by keyword, partial name, industry, location, or other filters.
+
 ```ruby
-result = client.rel(email: "tim.cook@apple.com")
-puts result.person.full_name  # => "Tim Cook"
+result = client.cse(
+  name: 'cufinder',
+  country: 'germany',
+  state: 'hamburg',
+  city: 'hamburg'
+)
+puts result
 ```
 
-#### 7. FCL - Find Company Lookalikes
+**PSE - Person Search**
+
+Search for people by name, company, job title, location, or other filters.
+
 ```ruby
-result = client.fcl(query: "tech startup")
-puts result.companies.length  # => 10
+result = client.pse(
+  full_name: 'iain mckenzie',
+  company_name: 'stripe'
+)
+puts result
 ```
 
-#### 8. ELF - Enrich LinkedIn Fundraising
+**LBS - Local Business Search (Google Maps Search API)**
+
+Search for local businesses by location, industry, or name.
+
 ```ruby
-result = client.elf(query: "tech company")
-puts result.fundraising.funding_money_raised  # => "$5M"
+result = client.lbs(
+  country: 'united states',
+  state: 'california',
+  page: 1
+)
+puts result
 ```
 
-#### 9. CAR - Company Annual Revenue
+**BCD - B2B Customers Finder**
+
+Returns B2B customers for a company
+
 ```ruby
-result = client.car(query: "Apple Inc")
-puts result.revenue  # => "$394.3B"
+result = client.bcd(url: "stripe.com")
+puts result
 ```
 
-#### 10. FCC - Find Company Children
+**CCP - Company Career Page Finder**
+
+Returns company's careers page URL
+
 ```ruby
-result = client.fcc(query: "Apple Inc")
-puts result.subsidiaries  # => ["Beats Electronics", "Shazam"]
+result = client.ccp(url: "stripe.com")
+puts result
 ```
 
-#### 11. FTS - Find Tech Stack
+**ISC - Company Saas Checker**
+
+Returns is company SaaS or not
+
 ```ruby
-result = client.fts(query: "web development")
-puts result.technologies  # => ["React", "Node.js", "Python"]
+result = client.isc(url: "stripe.com")
+puts result
 ```
 
-#### 12. EPP - Enrich Person Profile
+**CBC - Company B2B or B2C Checker**
+
+Returns company's business type
+
 ```ruby
-result = client.epp(linkedin_url: "linkedin.com/in/tim-cook")
-puts result.person.full_name  # => "Tim Cook"
+result = client.cbc(url: "stripe.com")
+puts result
 ```
 
-#### 13. FWE - Find Work Email
+**CSC - Company Mission Statement**
+
+Returns company's mission statement
+
 ```ruby
-result = client.fwe(linkedin_url: "linkedin.com/in/tim-cook")
-puts result.email  # => "tim.cook@apple.com"
+result = client.csc(url: "stripe.com")
+puts result
 ```
 
-#### 14. TEP - Title Email Phone
+**CSN - Company Snapshot**
+
+Returns company's snapshot information
+
 ```ruby
-result = client.tep(full_name: "Tim Cook", company: "Apple Inc")
-puts result.person.email  # => "tim.cook@apple.com"
-puts result.person.phone  # => "+1-408-996-1010"
+result = client.csn(url: "stripe.com")
+puts result
 ```
 
-#### 15. ENC - Enrich Company
+**NAO - Phone Number Normalizer**
+
+Returns normalized phone
+
 ```ruby
-result = client.enc(query: "Apple Inc")
-puts result.company.employee_count  # => 164000
+result = client.nao(phone: "+18006676389")
+puts result
 ```
 
-#### 16. CEC - Company Employee Count
+**NAA - Address Normalizer**
+
+Returns normalized address
+
 ```ruby
-result = client.cec(query: "Apple Inc")
-puts result.countries  # => {"US" => 100000, "CA" => 5000}
+result = client.naa(address: "1095 avenue of the Americas, 6th Avenue ny 10036")
+puts result
 ```
 
-#### 17. CLO - Company Locations
+**CEF - Company Employees Finder**
+
+Returns company's employees
+
 ```ruby
-result = client.clo(query: "Apple Inc")
-puts result.locations.first.city  # => "Cupertino"
+result = client.cef(query: "cufinder", page: 1)
+puts result
 ```
 
-#### 18. CSE - Company Search Engine
+**NAC - Company Name Normalizer**
+
+Returns normalized company name
+
 ```ruby
-result = client.cse(name: "tech", country: "US", industry: "software")
-puts result.companies.length  # => 50
+result = client.nac(company: "cufinder inc.")
+puts result
 ```
 
-#### 19. PSE - Person Search Engine
+**CAA - Company Activities API**
+
+Returns company's LinkedIn activities
+
 ```ruby
-result = client.pse(full_name: "John", country: "US", company_name: "Apple")
-puts result.peoples.length  # => 25
+result = client.caa(query: "cufinder", page: 1)
+puts result
 ```
 
-#### 20. LBS - Local Business Search
+**CJA - Company Jobs API**
+
+Returns company's job listings
+
 ```ruby
-result = client.lbs(name: "restaurant", city: "New York")
-puts result.companies.length  # => 100
+result = client.cja(name: "google", country: "united states", page: 1)
+puts result
 ```
 
-### Error Handling
+## Error Handling
 
-The Client provides comprehensive error handling:
+The SDK provides comprehensive error handling with custom error types:
 
 ```ruby
+require 'cufinder_ruby'
+
 begin
-  result = client.cuf(company_name: "Apple Inc", country_code: "US")
+  result = client.cuf(company_name: 'cufinder', country_code: 'US')
 rescue Cufinder::AuthenticationError => e
+  # 401 - Invalid API key
   puts "Authentication failed: #{e.message}"
+rescue Cufinder::CreditLimitError => e
+  # 400 - Not enough credit
+  puts "Not enough credit: #{e.message}"
+rescue Cufinder::NotFoundError => e
+  # 404 - Not found result
+  puts "Not found result: #{e.message}"
+rescue Cufinder::PayloadError => e
+  # 422 - Error in the payload
+  puts "Payload error: #{e.message}"
 rescue Cufinder::RateLimitError => e
+  # 429 - Rate limit exceeded
   puts "Rate limit exceeded: #{e.message}"
-rescue Cufinder::CreditLimitError => e
-  puts "Credit limit exceeded: #{e.message}"
-rescue Cufinder::ApiError => e
-  puts "API error #{e.status}: #{e.message}"
+rescue Cufinder::ServerError => e
+  # 500, 501, ... - Server errors
+  puts "Server error (#{e.status}): #{e.message}"
+rescue Cufinder::NetworkError => e
+  puts "Network error: #{e.message}"
 rescue Cufinder::ValidationError => e
   puts "Validation error: #{e.message}"
+rescue Cufinder::ApiError => e
+  puts "Unknown error: #{e.message}"
 end
 ```
 
-### Configuration
+## Types
 
-You can configure the Client with custom settings:
+The SDK exports comprehensive Ruby classes for all API requests and responses:
 
 ```ruby
-sdk = Cufinder::Client.new(
-  api_key: 'your-api-key',
-  timeout: 30,                              # Default
-  max_retries: 3                           # Default
-)
-```
+# Response classes
+class BaseResponse
+  attr_reader :query, :credit_count
+end
+
+# Model classes
+class Company
+  # The Company class contains all returned company data.
+  attr_reader :name, :domain, :website, :linkedin_url
+  attr_reader :country, :state, :city, :address
+  attr_reader :industry, :company_size, :revenue
+  attr_reader :employee_count, :subsidiaries, :tech_stack
+  attr_reader :emails, :phones, :description
+  attr_reader :locations, :founded_year, :logo_url
+end
+
+class Person
+  # The Person class contains all returned person data.
+  attr_reader :full_name, :first_name, :last_name
+  attr_reader :company_name, :company_domain, :job_title
+  attr_reader :country, :state, :city
+  attr_reader :email, :phone, :description, :linkedin_url
+end
+
+class LookalikeCompany
+  # The LookalikeCompany class contains all returned lookalike company data.
+  attr_reader :name, :domain, :website, :linkedin_url
+  attr_reader :country, :state, :city, :address
+  attr_reader :industry, :company_size, :revenue
+  attr_reader :employee_count, :subsidiaries, :tech_stack
+  attr_reader :emails, :phones, :description
+  attr_reader :locations, :founded_year, :logo_url
+end
+
+class FundraisingInfo
+  attr_reader :funding_last_round_type
+  attr_reader :funding_ammount_currency_code
+  attr_reader :funding_money_raised
+  attr_reader :funding_last_round_investors_url
+end
+
+class CompanyLocation
+  # The CompanyLocation class contains all returned company location data.
+  attr_reader :country, :state, :city, :postal_code
+  attr_reader :line1, :line2, :latitude, :longitude
+end
+
+class CompanySearchResult
+  attr_reader :companies, :total_results, :page
+  attr_reader :query, :credit_count
+end
+
+class PersonSearchResult
+  attr_reader :peoples, :total_results, :page
+  attr_reader :query, :credit_count
+end
+
+class LocalBusinessResult
+  attr_reader :businesses, :total_results, :page
+  attr_reader :query, :credit_count
+end
+
+# Configuration
+class ClientConfig
+  attr_accessor :api_key, :base_url, :timeout, :max_retries
+end
+
+# Error classes
+class CufinderError < StandardError; end
+class AuthenticationError < CufinderError; end
+class CreditLimitError < CufinderError; end
+class NotFoundError < CufinderError; end
+class PayloadError < CufinderError; end
+class RateLimitError < CufinderError; end
+class ServerError < CufinderError; end
+class NetworkError < CufinderError; end
+class ValidationError < CufinderError; end
+class ApiError < CufinderError; end
+```
+
+## Support
+
+For support, please open an issue on the [GitHub repository](https://github.com/cufinder/cufinder-ruby/issues).

data/cufinder-ruby.gemspec

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

data/lib/cufinder_ruby/client.rb

@@ -109,5 +109,53 @@ module Cufinder
     def lbs(**params)
       @services.search_local_businesses(params)
     end
+
+    def bcd(url:)
+      @services.extract_b2b_customers(url: url)
+    end
+
+    def ccp(url:)
+      @services.find_company_careers_page(url: url)
+    end
+
+    def isc(url:)
+      @services.is_saas(url: url)
+    end
+
+    def cbc(url:)
+      @services.get_company_business_type(url: url)
+    end
+
+    def csc(url:)
+      @services.get_company_mission_statement(url: url)
+    end
+
+    def csn(url:)
+      @services.get_company_snapshot(url: url)
+    end
+
+    def nao(phone:)
+      @services.normalize_phone(phone: phone)
+    end
+
+    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

@@ -164,6 +164,100 @@ module Cufinder
       response = @client.post("/lbs", params)
       LbsResponse.new(response)
     end
+
+    # BCD Service - B2B Customers Finder
+    def extract_b2b_customers(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/bcd", params)
+      BcdResponse.new(response)
+    end
+
+    # CCP Service - Company Career Page Finder
+    def find_company_careers_page(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/ccp", params)
+      CcpResponse.new(response)
+    end
+
+    # ISC Service - Company Saas Checker
+    def is_saas(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/isc", params)
+      IscResponse.new(response)
+    end
+
+    # CBC Service - Company B2B or B2C Checker
+    def get_company_business_type(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/cbc", params)
+      CbcResponse.new(response)
+    end
+
+    # CSC Service - Company Mission Statement
+    def get_company_mission_statement(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/csc", params)
+      CscResponse.new(response)
+    end
+
+    # CSN Service - Company Snapshot
+    def get_company_snapshot(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/csn", params)
+      CsnResponse.new(response)
+    end
+
+    # Nao Service - Phone Number Normalizer
+    def normalize_phone(params)
+      validate_required(params, [:phone])
+      
+      response = @client.post("/nao", params)
+      NaoResponse.new(response)
+    end
+
+    # Naa Service - Address Normalizer
+    def normalize_address(params)
+      validate_required(params, [:address])
+      
+      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

@@ -518,4 +518,229 @@ module Cufinder
       @companies = (data["companies"] || []).map { |c| Company.new(c) }
     end
   end
+  
+  class BcdResponse < BaseResponse
+    attr_accessor :customers
+    
+    def initialize(data = {})
+      super(data)
+      @customers = data["customers"] || []
+    end
+  end
+  
+  class CcpResponse < BaseResponse
+    attr_accessor :customers
+    
+    def initialize(data = {})
+      super(data)
+      @careers_page_url = data["careers_page_url"]
+    end
+  end
+  
+  class IscResponse < BaseResponse
+    attr_accessor :is_saas
+    
+    def initialize(data = {})
+      super(data)
+      @is_saas = data["is_saas"]
+    end
+  end
+  
+  class CbcResponse < BaseResponse
+    attr_accessor :business_type
+    
+    def initialize(data = {})
+      super(data)
+      @business_type = data["business_type"]
+    end
+  end
+  
+  class CscResponse < BaseResponse
+    attr_accessor :mission_statement
+    
+    def initialize(data = {})
+      super(data)
+      @mission_statement = data["mission_statement"]
+    end
+  end
+
+  class CsnSnapshotInfo
+    attr_accessor :icp, :target_industries, :target_personas, :value_proposition
+    
+    def initialize(data = {})
+      @icp = data["icp"]
+      @target_industries = data["target_industries"] || []
+      @target_personas = data["target_personas"]
+      @value_proposition = data["value_proposition"]
+    end
+  end
+
+  class CsnResponse < BaseResponse
+    attr_accessor :company_snapshot
+    
+    def initialize(data = {})
+      super(data)
+      @company_snapshot = data["company_snapshot"] ? CsnSnapshotInfo.new(data["company_snapshot"]) : nil
+    end
+  end
+
+  class NaoResponse < BaseResponse
+    attr_accessor :phone
+    
+    def initialize(data = {})
+      super(data)
+      @phone = data["phone"]
+    end
+  end
+
+  class NaaResponse < BaseResponse
+    attr_accessor :address
+    
+    def initialize(data = {})
+      super(data)
+      @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.0.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.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - CUFinder Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-12 00:00:00.000000000 Z
+date: 2026-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -89,6 +89,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - README.md