blitz-api-py 1.0.0__tar.gz → 2.0.0__tar.gz

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [2.0.0](https://github.com/api-blitz/blitz-api-py/compare/v1.0.0...v2.0.0) (2026-06-19)
+
+
+### ⚠ BREAKING CHANGES
+
+* spec-faithful type names for funding enum + distribution responses ([#17](https://github.com/api-blitz/blitz-api-py/issues/17)) (#18)
+
+### Features
+
+* spec-faithful type names for funding enum + distribution responses ([#17](https://github.com/api-blitz/blitz-api-py/issues/17)) ([#18](https://github.com/api-blitz/blitz-api-py/issues/18)) ([95370bd](https://github.com/api-blitz/blitz-api-py/commit/95370bdcd8771a40d9a6bdf921a609dca038bad5))
+
 ## [1.0.0](https://github.com/api-blitz/blitz-api-py/compare/v0.5.0...v1.0.0) (2026-06-19)
 
 

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blitz-api-py
-Version: 1.0.0
+Version: 2.0.0
 Summary: Typed Python SDK for the Blitz API — B2B data, search, and enrichment.
 Project-URL: Homepage, https://blitz-api.ai
 Project-URL: Documentation, https://docs.blitz-api.ai

blitz_api_py-2.0.0/src/blitz_api/_version.py

@@ -0,0 +1 @@
+__version__ = "2.0.0"  # x-release-please-version

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/src/blitz_api/resources/_async/enrichment.py

@@ -6,8 +6,8 @@ from typing import TYPE_CHECKING
 
 from ..._compat import TimeoutParam
 from ...types.enrichment import (
-    CompanyCountryDistributionResponse,
-    CompanyDepartmentDistributionResponse,
+    CompanyDistributionByCountryResponse,
+    CompanyDistributionByDepartmentResponse,
     CompanyEnrichmentResponse,
     DomainToLinkedinResponse,
     EmailEnrichmentResponse,
@@ -121,7 +121,7 @@ class AsyncEnrichmentResource:
 
     async def company_distribution_by_country(
         self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyCountryDistributionResponse:
+    ) -> CompanyDistributionByCountryResponse:
         """Get a company's employee count broken down by country.
 
         Countries are reported as ISO 3166-1 alpha-2 codes (e.g. ``US``, ``GB``);
@@ -131,13 +131,13 @@ class AsyncEnrichmentResource:
             "POST",
             _DISTRIBUTION_BY_COUNTRY,
             body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyCountryDistributionResponse,
+            cast_to=CompanyDistributionByCountryResponse,
             timeout=timeout,
         )
 
     async def company_distribution_by_department(
         self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyDepartmentDistributionResponse:
+    ) -> CompanyDistributionByDepartmentResponse:
         """Get a company's employee count broken down by department.
 
         Employees with no classified department are counted under ``"Other"``.
@@ -146,6 +146,6 @@ class AsyncEnrichmentResource:
             "POST",
             _DISTRIBUTION_BY_DEPARTMENT,
             body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyDepartmentDistributionResponse,
+            cast_to=CompanyDistributionByDepartmentResponse,
             timeout=timeout,
         )

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/src/blitz_api/resources/_sync/enrichment.py

@@ -8,8 +8,8 @@ from typing import TYPE_CHECKING
 
 from ..._compat import TimeoutParam
 from ...types.enrichment import (
-    CompanyCountryDistributionResponse,
-    CompanyDepartmentDistributionResponse,
+    CompanyDistributionByCountryResponse,
+    CompanyDistributionByDepartmentResponse,
     CompanyEnrichmentResponse,
     DomainToLinkedinResponse,
     EmailEnrichmentResponse,
@@ -123,7 +123,7 @@ class EnrichmentResource:
 
     def company_distribution_by_country(
         self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyCountryDistributionResponse:
+    ) -> CompanyDistributionByCountryResponse:
         """Get a company's employee count broken down by country.
 
         Countries are reported as ISO 3166-1 alpha-2 codes (e.g. ``US``, ``GB``);
@@ -133,13 +133,13 @@ class EnrichmentResource:
             "POST",
             _DISTRIBUTION_BY_COUNTRY,
             body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyCountryDistributionResponse,
+            cast_to=CompanyDistributionByCountryResponse,
             timeout=timeout,
         )
 
     def company_distribution_by_department(
         self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyDepartmentDistributionResponse:
+    ) -> CompanyDistributionByDepartmentResponse:
         """Get a company's employee count broken down by department.
 
         Employees with no classified department are counted under ``"Other"``.
@@ -148,6 +148,6 @@ class EnrichmentResource:
             "POST",
             _DISTRIBUTION_BY_DEPARTMENT,
             body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyDepartmentDistributionResponse,
+            cast_to=CompanyDistributionByDepartmentResponse,
             timeout=timeout,
         )

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/src/blitz_api/types/__init__.py

@@ -9,11 +9,11 @@ from __future__ import annotations
 
 from .account import ActivePlan, KeyInfo
 from .enrichment import (
-    CompanyCountryDistributionResponse,
-    CompanyDepartmentDistributionResponse,
+    CompanyDistributionByCountryItem,
+    CompanyDistributionByCountryResponse,
+    CompanyDistributionByDepartmentItem,
+    CompanyDistributionByDepartmentResponse,
     CompanyEnrichmentResponse,
-    CountryDistributionItem,
-    DepartmentDistributionItem,
     DomainToLinkedinResponse,
     EmailEnrichmentResponse,
     EmailMatch,
@@ -26,10 +26,10 @@ from .enums import (
     CompanyType,
     Continent,
     EmployeeRange,
-    FundingType,
     Industry,
     JobFunction,
     JobLevel,
+    LastFundingType,
     SalesRegion,
 )
 from .filters import (
@@ -37,9 +37,9 @@ from .filters import (
     CompanyFilter,
     CompanyHQFilter,
     CompanyTypeFilter,
-    FundingTypeFilter,
     IndustryFilter,
     KeywordFilter,
+    LastFundingTypeFilter,
     PeopleFilter,
     PeopleJobTitleFilter,
     PeopleLocationFilter,
@@ -75,7 +75,7 @@ __all__ = [
     "Industry",
     "CompanyType",
     "EmployeeRange",
-    "FundingType",
+    "LastFundingType",
     "Continent",
     "SalesRegion",
     "JobFunction",
@@ -84,7 +84,7 @@ __all__ = [
     "KeywordFilter",
     "IndustryFilter",
     "CompanyTypeFilter",
-    "FundingTypeFilter",
+    "LastFundingTypeFilter",
     "RangeFilter",
     "CompanyHQFilter",
     "CompanyFilter",
@@ -107,10 +107,10 @@ __all__ = [
     "CompanyEnrichmentResponse",
     "DomainToLinkedinResponse",
     "LinkedinToDomainResponse",
-    "CountryDistributionItem",
-    "CompanyCountryDistributionResponse",
-    "DepartmentDistributionItem",
-    "CompanyDepartmentDistributionResponse",
+    "CompanyDistributionByCountryItem",
+    "CompanyDistributionByCountryResponse",
+    "CompanyDistributionByDepartmentItem",
+    "CompanyDistributionByDepartmentResponse",
     # utils
     "CurrentDateResponse",
 ]

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/src/blitz_api/types/enrichment.py

@@ -14,10 +14,10 @@ __all__ = [
     "CompanyEnrichmentResponse",
     "DomainToLinkedinResponse",
     "LinkedinToDomainResponse",
-    "CountryDistributionItem",
-    "CompanyCountryDistributionResponse",
-    "DepartmentDistributionItem",
-    "CompanyDepartmentDistributionResponse",
+    "CompanyDistributionByCountryItem",
+    "CompanyDistributionByCountryResponse",
+    "CompanyDistributionByDepartmentItem",
+    "CompanyDistributionByDepartmentResponse",
 ]
 
 
@@ -80,7 +80,7 @@ class LinkedinToDomainResponse(BlitzModel):
     email_domain: str | None = None
 
 
-class CountryDistributionItem(BlitzModel):
+class CompanyDistributionByCountryItem(BlitzModel):
     """Employee count for a single country.
 
     ``country`` is an ISO 3166-1 alpha-2 code (e.g. ``"US"``, ``"GB"``), or the
@@ -94,7 +94,7 @@ class CountryDistributionItem(BlitzModel):
     percentage_ratio: float | None = None
 
 
-class CompanyCountryDistributionResponse(BlitzModel):
+class CompanyDistributionByCountryResponse(BlitzModel):
     """Result of ``enrichment.company_distribution_by_country``.
 
     Served by ``POST /v2/enrichment/company-distribution-by-country``.
@@ -102,10 +102,10 @@ class CompanyCountryDistributionResponse(BlitzModel):
 
     company_linkedin_url: str | None = None
     total_employees: int | None = None
-    distribution: list[CountryDistributionItem] = []
+    distribution: list[CompanyDistributionByCountryItem] = []
 
 
-class DepartmentDistributionItem(BlitzModel):
+class CompanyDistributionByDepartmentItem(BlitzModel):
     """Employee count for a single department (Blitz job function).
 
     Employees with no classified department are counted under ``"Other"``.
@@ -118,7 +118,7 @@ class DepartmentDistributionItem(BlitzModel):
     percentage_ratio: float | None = None
 
 
-class CompanyDepartmentDistributionResponse(BlitzModel):
+class CompanyDistributionByDepartmentResponse(BlitzModel):
     """Result of ``enrichment.company_distribution_by_department``.
 
     Served by ``POST /v2/enrichment/company-distribution-by-department``.
@@ -126,4 +126,4 @@ class CompanyDepartmentDistributionResponse(BlitzModel):
 
     company_linkedin_url: str | None = None
     total_employees: int | None = None
-    distribution: list[DepartmentDistributionItem] = []
+    distribution: list[CompanyDistributionByDepartmentItem] = []

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/src/blitz_api/types/enums.py

@@ -18,7 +18,7 @@ __all__ = [
     "SalesRegion",
     "JobFunction",
     "JobLevel",
-    "FundingType",
+    "LastFundingType",
 ]
 
 
@@ -634,7 +634,7 @@ class JobLevel(str, Enum):
     VP = 'VP'
 
 
-class FundingType(str, Enum):
+class LastFundingType(str, Enum):
     SERIES_UNKNOWN = 'Series unknown'
     PRE_SEED = 'Pre seed'
     SEED = 'Seed'

{blitz_api_py-1.0.0 → blitz_api_py-2.0.0}/src/blitz_api/types/filters.py

@@ -16,10 +16,10 @@ from .enums import (
     CompanyType,
     Continent,
     EmployeeRange,
-    FundingType,
     Industry,
     JobFunction,
     JobLevel,
+    LastFundingType,
     SalesRegion,
 )
 
@@ -31,7 +31,7 @@ from .enums import (
 IndustryValue = Industry | str
 CompanyTypeValue = CompanyType | str
 EmployeeRangeValue = EmployeeRange | str
-FundingTypeValue = FundingType | str
+LastFundingTypeValue = LastFundingType | str
 ContinentValue = Continent | str
 SalesRegionValue = SalesRegion | str
 JobFunctionValue = JobFunction | str
@@ -59,11 +59,11 @@ class CompanyTypeFilter(TypedDict, total=False):
     exclude: list[CompanyTypeValue]
 
 
-class FundingTypeFilter(TypedDict, total=False):
+class LastFundingTypeFilter(TypedDict, total=False):
     """Include/exclude filter over the last funding round type."""
 
-    include: list[FundingTypeValue]
-    exclude: list[FundingTypeValue]
+    include: list[LastFundingTypeValue]
+    exclude: list[LastFundingTypeValue]
 
 
 class RangeFilter(TypedDict, total=False):
@@ -101,7 +101,7 @@ class CompanyFilter(TypedDict, total=False):
     total_funding: RangeFilter
     last_funding_amount: RangeFilter
     last_funding_year: RangeFilter
-    last_funding_type: FundingTypeFilter
+    last_funding_type: LastFundingTypeFilter
     lead_investors: KeywordFilter
     keywords: KeywordFilter
     founded_year: RangeFilter

blitz_api_py-1.0.0/src/blitz_api/_version.py

@@ -1 +0,0 @@
-__version__ = "1.0.0"  # x-release-please-version