datafiniti-sdk 0.1.0__tar.gz

datafiniti_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: datafiniti-sdk
+Version: 0.1.0
+Summary: Python SDK for Datafiniti Data APIs (Business, People, Property, Product)
+Author-email: Leonard Trahan <leonard@datafiniti.co>
+License: MIT
+Keywords: datafiniti,api,sdk,business,property,people,product
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# Datafiniti SDK
+
+Python SDK for the [Datafiniti](https://datafiniti.co) Data APIs — Business, People, Property, and Product data.
+
+## Installation
+
+```bash
+pip install datafiniti-sdk
+```
+
+## Authentication
+
+All SDK classes require a Datafiniti API key. You can pass it directly or set it as an environment variable:
+
+```bash
+export DATAFINITI_API_KEY="your_api_key_here"
+```
+
+## Quick Start
+
+```python
+from datafiniti import DatafinitiBusinessSDK, DatafinitiPeopleSDK, PropertyDataSDK, DatafinitiProductSDK
+
+# Initialize from environment variable
+sdk = PropertyDataSDK.from_env()
+
+# Or pass the key directly
+sdk = PropertyDataSDK(api_key="your_api_key_here")
+```
+
+## Business Data
+
+```python
+from datafiniti import DatafinitiBusinessSDK
+
+sdk = DatafinitiBusinessSDK.from_env()
+
+# Search by name
+results = sdk.search_by_name("Starbucks", city="Seattle", num_records=5)
+
+# Count matching records
+count = sdk.count('name:"Starbucks" AND country:US')
+
+# Build a custom query
+query = sdk.query().country("US").build()
+results = sdk.search(query, num_records=10)
+
+# Paginate through large result sets
+for record in sdk.paginate('name:"Starbucks"', page_size=100, max_records=500):
+    print(record)
+```
+
+## People Data
+
+```python
+from datafiniti import DatafinitiPeopleSDK
+
+sdk = DatafinitiPeopleSDK.from_env()
+
+# Search by name
+results = sdk.search_by_name("John Smith", city="Austin", num_records=10)
+
+# Count matching records
+count = sdk.count('name:"John Smith" AND country:US')
+```
+
+## Property Data
+
+```python
+from datafiniti import PropertyDataSDK
+
+sdk = PropertyDataSDK.from_env()
+
+# Search by address
+results = sdk.search_by_address("123 Main St", postal_code="78701", num_records=1)
+
+# Find properties for sale
+results = sdk.for_sale(
+    postal_codes=["78701", "78702"],
+    property_types=["Single Family Residential"],
+    num_records=20
+)
+
+# Count matching records
+count = sdk.count('country:US AND mostRecentStatus:"For Sale"')
+
+# Paginate through results
+for record in sdk.paginate('country:US AND mostRecentStatus:"For Sale"', page_size=100):
+    print(record["address"])
+```
+
+## Product Data
+
+```python
+from datafiniti import DatafinitiProductSDK
+
+sdk = DatafinitiProductSDK.from_env()
+
+# Search by product name
+results = sdk.search_by_name("iPhone 15", brand="Apple", num_records=10)
+
+# Count matching records
+count = sdk.count('brand:"Apple"')
+```
+
+## Common Methods
+
+All four SDK classes inherit these methods:
+
+| Method | Description |
+| --- | --- |
+| `search(query, num_records)` | Search and return up to `num_records` results |
+| `count(query)` | Return the total number of matching records |
+| `paginate(query, page_size, max_records)` | Generator that yields records page by page |
+| `query()` | Returns a query builder for the data type |
+
+## Error Handling
+
+```python
+from datafiniti import DatafinitiAPIError
+
+try:
+    results = sdk.search("country:US", num_records=10)
+except DatafinitiAPIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Requirements
+
+- Python 3.9+
+- `requests >= 2.31.0`
+
+## License
+
+MIT

datafiniti_sdk-0.1.0/README.md

@@ -0,0 +1,135 @@
+# Datafiniti SDK
+
+Python SDK for the [Datafiniti](https://datafiniti.co) Data APIs — Business, People, Property, and Product data.
+
+## Installation
+
+```bash
+pip install datafiniti-sdk
+```
+
+## Authentication
+
+All SDK classes require a Datafiniti API key. You can pass it directly or set it as an environment variable:
+
+```bash
+export DATAFINITI_API_KEY="your_api_key_here"
+```
+
+## Quick Start
+
+```python
+from datafiniti import DatafinitiBusinessSDK, DatafinitiPeopleSDK, PropertyDataSDK, DatafinitiProductSDK
+
+# Initialize from environment variable
+sdk = PropertyDataSDK.from_env()
+
+# Or pass the key directly
+sdk = PropertyDataSDK(api_key="your_api_key_here")
+```
+
+## Business Data
+
+```python
+from datafiniti import DatafinitiBusinessSDK
+
+sdk = DatafinitiBusinessSDK.from_env()
+
+# Search by name
+results = sdk.search_by_name("Starbucks", city="Seattle", num_records=5)
+
+# Count matching records
+count = sdk.count('name:"Starbucks" AND country:US')
+
+# Build a custom query
+query = sdk.query().country("US").build()
+results = sdk.search(query, num_records=10)
+
+# Paginate through large result sets
+for record in sdk.paginate('name:"Starbucks"', page_size=100, max_records=500):
+    print(record)
+```
+
+## People Data
+
+```python
+from datafiniti import DatafinitiPeopleSDK
+
+sdk = DatafinitiPeopleSDK.from_env()
+
+# Search by name
+results = sdk.search_by_name("John Smith", city="Austin", num_records=10)
+
+# Count matching records
+count = sdk.count('name:"John Smith" AND country:US')
+```
+
+## Property Data
+
+```python
+from datafiniti import PropertyDataSDK
+
+sdk = PropertyDataSDK.from_env()
+
+# Search by address
+results = sdk.search_by_address("123 Main St", postal_code="78701", num_records=1)
+
+# Find properties for sale
+results = sdk.for_sale(
+    postal_codes=["78701", "78702"],
+    property_types=["Single Family Residential"],
+    num_records=20
+)
+
+# Count matching records
+count = sdk.count('country:US AND mostRecentStatus:"For Sale"')
+
+# Paginate through results
+for record in sdk.paginate('country:US AND mostRecentStatus:"For Sale"', page_size=100):
+    print(record["address"])
+```
+
+## Product Data
+
+```python
+from datafiniti import DatafinitiProductSDK
+
+sdk = DatafinitiProductSDK.from_env()
+
+# Search by product name
+results = sdk.search_by_name("iPhone 15", brand="Apple", num_records=10)
+
+# Count matching records
+count = sdk.count('brand:"Apple"')
+```
+
+## Common Methods
+
+All four SDK classes inherit these methods:
+
+| Method | Description |
+| --- | --- |
+| `search(query, num_records)` | Search and return up to `num_records` results |
+| `count(query)` | Return the total number of matching records |
+| `paginate(query, page_size, max_records)` | Generator that yields records page by page |
+| `query()` | Returns a query builder for the data type |
+
+## Error Handling
+
+```python
+from datafiniti import DatafinitiAPIError
+
+try:
+    results = sdk.search("country:US", num_records=10)
+except DatafinitiAPIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Requirements
+
+- Python 3.9+
+- `requests >= 2.31.0`
+
+## License
+
+MIT

datafiniti_sdk-0.1.0/datafiniti/__init__.py

@@ -0,0 +1,13 @@
+from .business.sdk import DatafinitiBusinessSDK
+from .people.sdk import DatafinitiPeopleSDK
+from .property.sdk import PropertyDataSDK
+from .product.sdk import DatafinitiProductSDK
+from .errors import DatafinitiAPIError
+
+__all__ = [
+    "DatafinitiBusinessSDK",
+    "DatafinitiPeopleSDK",
+    "PropertyDataSDK",
+    "DatafinitiProductSDK",
+    "DatafinitiAPIError",
+]

datafiniti_sdk-0.1.0/datafiniti/_base.py

@@ -0,0 +1,109 @@
+import os
+import time
+import requests
+
+from .errors import DatafinitiAPIError
+
+
+class BaseDatafinitiSDK:
+    BASE_URL = ""
+
+    def __init__(self, api_key=None, timeout=60, max_retries=3):
+        self.api_key = api_key or os.getenv("DATAFINITI_API_KEY")
+        self.timeout = timeout
+        self.max_retries = max_retries
+
+        if not self.api_key:
+            raise ValueError(
+                "Missing Datafiniti API key. Pass api_key or set DATAFINITI_API_KEY."
+            )
+
+    @classmethod
+    def from_env(cls):
+        return cls(api_key=os.getenv("DATAFINITI_API_KEY"))
+
+    def _headers(self):
+        return {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json",
+        }
+
+    def _post(self, endpoint, payload, params=None):
+        url = f"{self.BASE_URL}/{endpoint.lstrip('/')}"
+        last_error = None
+
+        for attempt in range(1, self.max_retries + 1):
+            try:
+                response = requests.post(
+                    url,
+                    json=payload,
+                    params=params,
+                    headers=self._headers(),
+                    timeout=self.timeout,
+                )
+
+                if response.status_code in (408, 429, 500, 502, 503, 504):
+                    last_error = response
+                    time.sleep(2 ** (attempt - 1))
+                    continue
+
+                if not response.ok:
+                    raise DatafinitiAPIError(
+                        message=f"Datafiniti API error: {response.status_code}",
+                        status_code=response.status_code,
+                        response_body=response.text,
+                    )
+
+                return response.json()
+
+            except requests.RequestException as exc:
+                last_error = exc
+                time.sleep(2 ** (attempt - 1))
+
+        raise DatafinitiAPIError(
+            message="Datafiniti API request failed after retries.",
+            response_body=str(last_error),
+        )
+
+    def search(self, query, num_records=10, format="JSON", view=None, download=False):
+        payload = {
+            "query": query,
+            "num_records": num_records,
+            "format": format,
+        }
+        if view:
+            payload["view"] = view
+        if download:
+            payload["download"] = True
+        return self._post("search", payload)
+
+    def count(self, query):
+        response = self.search(query=query, num_records=0)
+        return response.get("num_found", 0)
+
+    def paginate(self, query, page_size=100, max_records=None, format="JSON", view=None):
+        page = 1
+        total_yielded = 0
+
+        while True:
+            payload = {"query": query, "format": format}
+            if view:
+                payload["view"] = view
+
+            response = self._post(
+                endpoint="paginate",
+                payload=payload,
+                params={"page": page, "limit": page_size},
+            )
+
+            records = response.get("records", [])
+            if not records:
+                break
+
+            for record in records:
+                yield record
+                total_yielded += 1
+                if max_records and total_yielded >= max_records:
+                    return
+
+            page += 1

datafiniti_sdk-0.1.0/datafiniti/business/__init__.py

@@ -0,0 +1,4 @@
+from .sdk import DatafinitiBusinessSDK
+from .queries import BusinessQuery
+
+__all__ = ["DatafinitiBusinessSDK", "BusinessQuery"]

datafiniti_sdk-0.1.0/datafiniti/business/queries.py

@@ -0,0 +1,50 @@
+class BusinessQuery:
+    def __init__(self):
+        self.parts = []
+
+    def raw(self, query):
+        self.parts.append(f"({query})")
+        return self
+
+    def country(self, country):
+        self.parts.append(f"country:{country}")
+        return self
+
+    def province(self, province):
+        self.parts.append(f'province:"{province}"')
+        return self
+
+    def city(self, city):
+        self.parts.append(f'city:"{city}"')
+        return self
+
+    def postal_code(self, postal_code):
+        self.parts.append(f'postalCode:"{postal_code}"')
+        return self
+
+    def postal_codes(self, postal_codes):
+        values = " OR ".join([f'"{code}"' for code in postal_codes])
+        self.parts.append(f"postalCode:({values})")
+        return self
+
+    def name(self, name):
+        self.parts.append(f'name:"{name}"')
+        return self
+
+    def categories(self, categories):
+        if isinstance(categories, str):
+            categories = [categories]
+        values = " OR ".join([f'"{cat}"' for cat in categories])
+        self.parts.append(f"categories:({values})")
+        return self
+
+    def updated_after(self, date_string):
+        self.parts.append(f"dateUpdated:[{date_string} TO *]")
+        return self
+
+    def has_field(self, field):
+        self.parts.append(f"{field}:*")
+        return self
+
+    def build(self):
+        return " AND ".join(self.parts)

datafiniti_sdk-0.1.0/datafiniti/business/sdk.py

@@ -0,0 +1,17 @@
+from .._base import BaseDatafinitiSDK
+from .queries import BusinessQuery
+
+
+class DatafinitiBusinessSDK(BaseDatafinitiSDK):
+    BASE_URL = "https://api.datafiniti.co/v4/businesses"
+
+    def query(self):
+        return BusinessQuery()
+
+    def search_by_name(self, name, city=None, country="US", num_records=10):
+        parts = [f'name:"{name}"']
+        if city:
+            parts.append(f'city:"{city}"')
+        if country:
+            parts.append(f"country:{country}")
+        return self.search(" AND ".join(parts), num_records=num_records)

datafiniti_sdk-0.1.0/datafiniti/errors.py

@@ -0,0 +1,7 @@
+class DatafinitiAPIError(Exception):
+    """Raised when the Datafiniti API returns an error response."""
+
+    def __init__(self, message, status_code=None, response_body=None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.response_body = response_body

datafiniti_sdk-0.1.0/datafiniti/people/__init__.py

@@ -0,0 +1,4 @@
+from .sdk import DatafinitiPeopleSDK
+from .queries import PeopleQuery
+
+__all__ = ["DatafinitiPeopleSDK", "PeopleQuery"]

datafiniti_sdk-0.1.0/datafiniti/people/queries.py

@@ -0,0 +1,38 @@
+class PeopleQuery:
+    def __init__(self):
+        self.parts = []
+
+    def raw(self, query):
+        self.parts.append(f"({query})")
+        return self
+
+    def country(self, country):
+        self.parts.append(f"country:{country}")
+        return self
+
+    def province(self, province):
+        self.parts.append(f'province:"{province}"')
+        return self
+
+    def city(self, city):
+        self.parts.append(f'city:"{city}"')
+        return self
+
+    def postal_code(self, postal_code):
+        self.parts.append(f'postalCode:"{postal_code}"')
+        return self
+
+    def name(self, name):
+        self.parts.append(f'name:"{name}"')
+        return self
+
+    def updated_after(self, date_string):
+        self.parts.append(f"dateUpdated:[{date_string} TO *]")
+        return self
+
+    def has_field(self, field):
+        self.parts.append(f"{field}:*")
+        return self
+
+    def build(self):
+        return " AND ".join(self.parts)

datafiniti_sdk-0.1.0/datafiniti/people/sdk.py

@@ -0,0 +1,17 @@
+from .._base import BaseDatafinitiSDK
+from .queries import PeopleQuery
+
+
+class DatafinitiPeopleSDK(BaseDatafinitiSDK):
+    BASE_URL = "https://api.datafiniti.co/v4/people"
+
+    def query(self):
+        return PeopleQuery()
+
+    def search_by_name(self, name, city=None, country="US", num_records=10):
+        parts = [f'name:"{name}"']
+        if city:
+            parts.append(f'city:"{city}"')
+        if country:
+            parts.append(f"country:{country}")
+        return self.search(" AND ".join(parts), num_records=num_records)

datafiniti_sdk-0.1.0/datafiniti/product/__init__.py

@@ -0,0 +1,4 @@
+from .sdk import DatafinitiProductSDK
+from .queries import ProductQuery
+
+__all__ = ["DatafinitiProductSDK", "ProductQuery"]

datafiniti_sdk-0.1.0/datafiniti/product/queries.py

@@ -0,0 +1,39 @@
+class ProductQuery:
+    def __init__(self):
+        self.parts = []
+
+    def raw(self, query):
+        self.parts.append(f"({query})")
+        return self
+
+    def name(self, name):
+        self.parts.append(f'name:"{name}"')
+        return self
+
+    def brand(self, brand):
+        self.parts.append(f'brand:"{brand}"')
+        return self
+
+    def categories(self, categories):
+        if isinstance(categories, str):
+            categories = [categories]
+        values = " OR ".join([f'"{cat}"' for cat in categories])
+        self.parts.append(f"categories:({values})")
+        return self
+
+    def price_range(self, min_price=None, max_price=None):
+        min_val = min_price if min_price is not None else "*"
+        max_val = max_price if max_price is not None else "*"
+        self.parts.append(f"prices.amountMin:[{min_val} TO {max_val}]")
+        return self
+
+    def updated_after(self, date_string):
+        self.parts.append(f"dateUpdated:[{date_string} TO *]")
+        return self
+
+    def has_field(self, field):
+        self.parts.append(f"{field}:*")
+        return self
+
+    def build(self):
+        return " AND ".join(self.parts)

datafiniti_sdk-0.1.0/datafiniti/product/sdk.py

@@ -0,0 +1,15 @@
+from .._base import BaseDatafinitiSDK
+from .queries import ProductQuery
+
+
+class DatafinitiProductSDK(BaseDatafinitiSDK):
+    BASE_URL = "https://api.datafiniti.co/v4/products"
+
+    def query(self):
+        return ProductQuery()
+
+    def search_by_name(self, name, brand=None, num_records=10):
+        parts = [f'name:"{name}"']
+        if brand:
+            parts.append(f'brand:"{brand}"')
+        return self.search(" AND ".join(parts), num_records=num_records)

datafiniti_sdk-0.1.0/datafiniti/property/__init__.py

@@ -0,0 +1,4 @@
+from .sdk import PropertyDataSDK
+from .queries import PropertyQuery
+
+__all__ = ["PropertyDataSDK", "PropertyQuery"]

datafiniti_sdk-0.1.0/datafiniti/property/queries.py

@@ -0,0 +1,64 @@
+class PropertyQuery:
+    def __init__(self):
+        self.parts = []
+
+    def raw(self, query):
+        self.parts.append(f"({query})")
+        return self
+
+    def country(self, country):
+        self.parts.append(f"country:{country}")
+        return self
+
+    def province(self, province):
+        self.parts.append(f'province:"{province}"')
+        return self
+
+    def city(self, city):
+        self.parts.append(f'city:"{city}"')
+        return self
+
+    def postal_code(self, postal_code):
+        self.parts.append(f'postalCode:"{postal_code}"')
+        return self
+
+    def postal_codes(self, postal_codes):
+        values = " OR ".join([f'"{code}"' for code in postal_codes])
+        self.parts.append(f"postalCode:({values})")
+        return self
+
+    def address(self, address):
+        self.parts.append(f'address:"{address}"')
+        return self
+
+    def most_recent_status(self, statuses):
+        if isinstance(statuses, str):
+            statuses = [statuses]
+        values = " OR ".join([f'"{status}"' for status in statuses])
+        self.parts.append(f"mostRecentStatus:({values})")
+        return self
+
+    def most_recent_rental_status(self, statuses):
+        if isinstance(statuses, str):
+            statuses = [statuses]
+        values = " OR ".join([f'"{status}"' for status in statuses])
+        self.parts.append(f"mostRecentRentalStatus:({values})")
+        return self
+
+    def property_types(self, property_types):
+        if isinstance(property_types, str):
+            property_types = [property_types]
+        values = " OR ".join([f'"{ptype}"' for ptype in property_types])
+        self.parts.append(f"propertyType:({values})")
+        return self
+
+    def updated_after(self, date_string):
+        self.parts.append(f"dateUpdated:[{date_string} TO *]")
+        return self
+
+    def has_field(self, field):
+        self.parts.append(f"{field}:*")
+        return self
+
+    def build(self):
+        return " AND ".join(self.parts)

datafiniti_sdk-0.1.0/datafiniti/property/sdk.py

@@ -0,0 +1,29 @@
+from .._base import BaseDatafinitiSDK
+from .queries import PropertyQuery
+
+
+class PropertyDataSDK(BaseDatafinitiSDK):
+    BASE_URL = "https://api.datafiniti.co/v4/properties"
+
+    def query(self):
+        return PropertyQuery()
+
+    def search_by_address(self, address, postal_code=None, country="US", num_records=1):
+        parts = [f'address:"{address}"']
+        if postal_code:
+            parts.append(f'postalCode:"{postal_code}"')
+        if country:
+            parts.append(f"country:{country}")
+        return self.search(" AND ".join(parts), num_records=num_records)
+
+    def for_sale(self, postal_codes=None, property_types=None, num_records=10):
+        builder = (
+            self.query()
+            .country("US")
+            .most_recent_status(["For Sale", "Coming Soon", "Pending"])
+        )
+        if postal_codes:
+            builder.postal_codes(postal_codes)
+        if property_types:
+            builder.property_types(property_types)
+        return self.search(builder.build(), num_records=num_records)

datafiniti_sdk-0.1.0/datafiniti_sdk.egg-info/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: datafiniti-sdk
+Version: 0.1.0
+Summary: Python SDK for Datafiniti Data APIs (Business, People, Property, Product)
+Author-email: Leonard Trahan <leonard@datafiniti.co>
+License: MIT
+Keywords: datafiniti,api,sdk,business,property,people,product
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# Datafiniti SDK
+
+Python SDK for the [Datafiniti](https://datafiniti.co) Data APIs — Business, People, Property, and Product data.
+
+## Installation
+
+```bash
+pip install datafiniti-sdk
+```
+
+## Authentication
+
+All SDK classes require a Datafiniti API key. You can pass it directly or set it as an environment variable:
+
+```bash
+export DATAFINITI_API_KEY="your_api_key_here"
+```
+
+## Quick Start
+
+```python
+from datafiniti import DatafinitiBusinessSDK, DatafinitiPeopleSDK, PropertyDataSDK, DatafinitiProductSDK
+
+# Initialize from environment variable
+sdk = PropertyDataSDK.from_env()
+
+# Or pass the key directly
+sdk = PropertyDataSDK(api_key="your_api_key_here")
+```
+
+## Business Data
+
+```python
+from datafiniti import DatafinitiBusinessSDK
+
+sdk = DatafinitiBusinessSDK.from_env()
+
+# Search by name
+results = sdk.search_by_name("Starbucks", city="Seattle", num_records=5)
+
+# Count matching records
+count = sdk.count('name:"Starbucks" AND country:US')
+
+# Build a custom query
+query = sdk.query().country("US").build()
+results = sdk.search(query, num_records=10)
+
+# Paginate through large result sets
+for record in sdk.paginate('name:"Starbucks"', page_size=100, max_records=500):
+    print(record)
+```
+
+## People Data
+
+```python
+from datafiniti import DatafinitiPeopleSDK
+
+sdk = DatafinitiPeopleSDK.from_env()
+
+# Search by name
+results = sdk.search_by_name("John Smith", city="Austin", num_records=10)
+
+# Count matching records
+count = sdk.count('name:"John Smith" AND country:US')
+```
+
+## Property Data
+
+```python
+from datafiniti import PropertyDataSDK
+
+sdk = PropertyDataSDK.from_env()
+
+# Search by address
+results = sdk.search_by_address("123 Main St", postal_code="78701", num_records=1)
+
+# Find properties for sale
+results = sdk.for_sale(
+    postal_codes=["78701", "78702"],
+    property_types=["Single Family Residential"],
+    num_records=20
+)
+
+# Count matching records
+count = sdk.count('country:US AND mostRecentStatus:"For Sale"')
+
+# Paginate through results
+for record in sdk.paginate('country:US AND mostRecentStatus:"For Sale"', page_size=100):
+    print(record["address"])
+```
+
+## Product Data
+
+```python
+from datafiniti import DatafinitiProductSDK
+
+sdk = DatafinitiProductSDK.from_env()
+
+# Search by product name
+results = sdk.search_by_name("iPhone 15", brand="Apple", num_records=10)
+
+# Count matching records
+count = sdk.count('brand:"Apple"')
+```
+
+## Common Methods
+
+All four SDK classes inherit these methods:
+
+| Method | Description |
+| --- | --- |
+| `search(query, num_records)` | Search and return up to `num_records` results |
+| `count(query)` | Return the total number of matching records |
+| `paginate(query, page_size, max_records)` | Generator that yields records page by page |
+| `query()` | Returns a query builder for the data type |
+
+## Error Handling
+
+```python
+from datafiniti import DatafinitiAPIError
+
+try:
+    results = sdk.search("country:US", num_records=10)
+except DatafinitiAPIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+## Requirements
+
+- Python 3.9+
+- `requests >= 2.31.0`
+
+## License
+
+MIT

datafiniti_sdk-0.1.0/datafiniti_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+README.md
+pyproject.toml
+datafiniti/__init__.py
+datafiniti/_base.py
+datafiniti/errors.py
+datafiniti/business/__init__.py
+datafiniti/business/queries.py
+datafiniti/business/sdk.py
+datafiniti/people/__init__.py
+datafiniti/people/queries.py
+datafiniti/people/sdk.py
+datafiniti/product/__init__.py
+datafiniti/product/queries.py
+datafiniti/product/sdk.py
+datafiniti/property/__init__.py
+datafiniti/property/queries.py
+datafiniti/property/sdk.py
+datafiniti_sdk.egg-info/PKG-INFO
+datafiniti_sdk.egg-info/SOURCES.txt
+datafiniti_sdk.egg-info/dependency_links.txt
+datafiniti_sdk.egg-info/requires.txt
+datafiniti_sdk.egg-info/top_level.txt

datafiniti_sdk-0.1.0/datafiniti_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

datafiniti_sdk-0.1.0/datafiniti_sdk.egg-info/requires.txt

@@ -0,0 +1,4 @@
+requests>=2.31.0
+
+[dev]
+pytest>=8.0.0

datafiniti_sdk-0.1.0/datafiniti_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+datafiniti

datafiniti_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "datafiniti-sdk"
+version = "0.1.0"
+description = "Python SDK for Datafiniti Data APIs (Business, People, Property, Product)"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Leonard Trahan", email = "leonard@datafiniti.co" }]
+keywords = ["datafiniti", "api", "sdk", "business", "property", "people", "product"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "requests>=2.31.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0"
+]
+
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["datafiniti*"]

datafiniti_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+