Merge branch 'release/v1.1.0'

Author: MortezaHeydari97

CHANGELOG.md

@@ -1,6 +1,16 @@
 # Cufinder Python SDK Changelog
 
-## 1.0.0
+## 1.1.0 (January 31, 2025)
+
+#### 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
+
+
+## 1.0.0 (November 4, 2025)
 
 #### Documentation
 - Updated all service method examples with correct SDK usage patterns
@@ -15,7 +25,7 @@
 
 
 
-## 0.1.0
+## 0.1.0 (October 9, 2025)
 
 #### Features
 - Initial release of the Cufinder Python SDK
@@ -43,6 +53,6 @@
 
 
 
-## 0.0.1
+## 0.0.1 (October 8, 2025)
 
 Initial release of the Cufinder Python SDK with core functionality.

README.md

@@ -35,7 +35,7 @@ client = Cufinder('your-api-key-here', timeout=60)
 
 ## API Reference
 
-This SDK covers all 20 Cufinder API (v2) endpoints:
+This SDK covers all 28 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)
@@ -57,6 +57,14 @@ This SDK covers all 20 Cufinder API (v2) endpoints:
 - **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)
 
 
 **CUF - Company Name to Domain**
@@ -251,6 +259,78 @@ result = client.lbs(
 print(result)
 ```
 
+**BCD - B2B Customers Finder**
+
+Returns company's careers page
+
+```python
+result = client.bcd('stripe.com')
+print(result)
+```
+
+**CCP - Company Career Page Finder**
+
+Returns is company SaaS or not
+
+```python
+result = client.ccp('stripe.com')
+print(result)
+```
+
+**ISC - Company Saas Checker**
+
+Returns is company SaaS or not
+
+```python
+result = client.isc('stripe.com')
+print(result)
+```
+
+**CBC - Company B2B or B2C Checker**
+
+Returns company's business type
+
+```python
+result = client.cbc('stripe.com')
+print(result)
+```
+
+**CSC - Company Mission Statement**
+
+Returns company's mission statement
+
+```python
+result = client.csc('stripe.com')
+print(result)
+```
+
+**CSN - Company Snapshot**
+
+Returns company's snapshot information
+
+```python
+result = client.csn('stripe.com')
+print(result)
+```
+
+**NAO - Phone Number Normalizer**
+
+Returns normalized phone
+
+```python
+result = client.nao('+18006676389')
+print(result)
+```
+
+**NAA - Address Normalizer**
+
+Returns normalized address
+
+```python
+result = client.naa('1095 avenue of the Americas, 6th Avenue ny 10036')
+print(result)
+```
+
 ## Error Handling
 
 The SDK provides comprehensive error handling with custom error types:

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cufinder-py"
-version = "1.0.1"
+version = "1.1.0"
 description = "Python SDK for the CUFinder API."
 readme = "README.md"
 requires-python = ">=3.8"

setup.py

@@ -14,7 +14,7 @@
 
 setup(
     name="cufinder-py",
-    version="1.0.1",
+    version="1.1.0",
     author="Cufinder Team",
     author_email="support@cufinder.io",
     description="Type-safe Python SDK for easily integrating with the Cufinder API",

src/cufinder/__init__.py

@@ -34,7 +34,7 @@
 from .services import *
 from .types import CseParams, PseParams, LbsParams
 
-__version__ = "1.0.1"
+__version__ = "1.1.0"
 __author__ = "CUFinder Team"
 __email__ = "support@cufinder.io"
 
@@ -89,6 +89,14 @@
     "CseResponse",
     "PseResponse",
     "LcufResponse",
+    "BcdResponse",
+    "CcpResponse",
+    "IscResponse",
+    "CbcResponse",
+    "CscResponse",
+    "CsnResponse",
+    "NaoResponse",
+    "NaaResponse",
     # Services
     "BaseService",
     "Cuf",
@@ -111,6 +119,14 @@
     "Cse",
     "Pse",
     "Lcuf",
+    "Bcd",
+    "Ccp",
+    "Isc",
+    "Cbc",
+    "Csc",
+    "Csn",
+    "Nao",
+    "Naa",
     # Types
     "CseParams",
     "PseParams", 

src/cufinder/base_api_client.py

@@ -96,7 +96,7 @@ def __init__(self, config: CufinderClientConfig, api_key: str):
         self.session.headers.update({
             'x-api-key': api_key,
             'Content-Type': 'application/x-www-form-urlencoded',
-            'User-Agent': 'cufinder-py/1.0.1',
+            'User-Agent': 'cufinder-py/1.1.0',
         })
 
         # Set default timeout

src/cufinder/models/__init__.py

@@ -24,6 +24,14 @@
     CseResponse,
     PseResponse,
     LcufResponse,
+    BcdResponse,
+    CcpResponse,
+    IscResponse,
+    CbcResponse,
+    CscResponse,
+    CsnResponse,
+    NaoResponse,
+    NaaResponse,
 )
 
 __all__ = [
@@ -50,4 +58,12 @@
     "CseResponse",
     "PseResponse",
     "LcufResponse",
+    "BcdResponse",
+    "CcpResponse",
+    "IscResponse",
+    "CbcResponse",
+    "CscResponse",
+    "CsnResponse",
+    "NaoResponse",
+    "NaaResponse",
 ]

src/cufinder/models/company.py

@@ -135,4 +135,12 @@ class CloCompanyLocation(BaseModel):
     line1: Optional[str] = None
     line2: Optional[str] = None
     latitude: Optional[float] = None
-    longitude: Optional[float] = None
+    longitude: Optional[float] = None
+
+
+class SnapshotModel(BaseModel):
+    """Snapshot info model"""
+    icp: str | None
+    target_industries: List[str];
+    target_personas: List[str];
+    value_proposition: str | None

src/cufinder/models/responses.py

@@ -3,7 +3,7 @@
 from typing import List, Optional, Union
 
 from .base import BaseResponse
-from .company import Company, CompanySearchResult, LocalBusinessResult, LookalikeCompany, FundraisingInfo, CloCompanyLocation
+from .company import Company, CompanySearchResult, LocalBusinessResult, LookalikeCompany, FundraisingInfo, CloCompanyLocation, SnapshotModel
 from .person import Person, PersonSearchResult, TepPerson
 
 
@@ -105,3 +105,36 @@ class PseResponse(BaseResponse):
 class LbsResponse(BaseResponse):
     """LBS Response - Local Business Search"""
     companies: List[LocalBusinessResult]
+
+
+class BcdResponse(BaseResponse):
+    """BCD Response - Extract B2B Customers From the Domain"""
+    customers: List[str]
+
+
+class CcpResponse(BaseResponse):
+    careers_page_url: str | None
+
+
+class IscResponse(BaseResponse):
+    is_saas: str
+
+
+class CbcResponse(BaseResponse):
+    business_type: str
+
+
+class CscResponse(BaseResponse):
+    mission_statement: str | None
+
+
+class CsnResponse(BaseResponse):
+    company_snapshot: SnapshotModel
+
+
+class NaoResponse(BaseResponse):
+    phone: str
+
+
+class NaaResponse(BaseResponse):
+    address: str