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

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

@@ -1,5 +1,23 @@
 # Changelog
 
+## [1.0.0](https://github.com/api-blitz/blitz-api-py/compare/v0.5.0...v1.0.0) (2026-06-19)
+
+
+### ⚠ BREAKING CHANGES
+
+* funding/HQ-state search filters + relocate distribution endpoints ([#15](https://github.com/api-blitz/blitz-api-py/issues/15))
+
+### Features
+
+* funding/HQ-state search filters + relocate distribution endpoints ([#15](https://github.com/api-blitz/blitz-api-py/issues/15)) ([f711ee8](https://github.com/api-blitz/blitz-api-py/commit/f711ee81a9e046bd7e354b593eda9e8d978768e3))
+
+## [0.5.0](https://github.com/api-blitz/blitz-api-py/compare/v0.4.0...v0.5.0) (2026-06-18)
+
+
+### Features
+
+* scope client-side rate limiting per endpoint ([#13](https://github.com/api-blitz/blitz-api-py/issues/13)) ([de5308b](https://github.com/api-blitz/blitz-api-py/commit/de5308b6995edc68dd1e43a8554296b7de095df2))
+
 ## [0.4.0](https://github.com/api-blitz/blitz-api-py/compare/v0.3.0...v0.4.0) (2026-06-17)
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blitz-api-py
-Version: 0.4.0
+Version: 1.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
@@ -199,8 +199,8 @@ All methods are grouped into four namespaces:
 | --- | --- |
 | `client.account` | `key_info()` |
 | `client.search` | `people()`, `companies()`, `employee_finder()`, `waterfall_icp()` |
-| `client.enrichment` | `email()`, `phone()`, `email_to_person()`, `phone_to_person()`, `company()`, `domain_to_linkedin()`, `linkedin_to_domain()` |
-| `client.utils` | `current_date()`, `company_employment_distribution()`, `company_department_distribution()` |
+| `client.enrichment` | `email()`, `phone()`, `email_to_person()`, `phone_to_person()`, `company()`, `domain_to_linkedin()`, `linkedin_to_domain()`, `company_distribution_by_country()`, `company_distribution_by_department()` |
+| `client.utils` | `current_date()` |
 
 Every method returns a typed Pydantic model (see `blitz_api.types`). Enum-backed
 filter fields (e.g. `Industry`, `JobLevel`, `Continent`) accept either an enum
@@ -258,10 +258,13 @@ client = BlitzAPI(
 ```
 
 The client-side rate limiter is a sliding window — at most `rate_limit_rps` requests
-in any rolling second — so a single client instance stays under the API's limit (5 req/s
-by default; check your key's limit via
-`client.account.key_info().max_requests_per_seconds`). Across multiple processes you may
-still hit `429` — the retry path handles that.
+in any rolling second — applied **per endpoint**: each endpoint (e.g. `.email` vs
+`.phone`) is throttled independently, mirroring the API's own limit, which is also per
+endpoint (5 req/s by default; check yours via
+`client.account.key_info().max_requests_per_seconds`). A single client instance therefore
+stays under the limit on every endpoint, so a burst on one never blocks another. Across
+multiple processes — which share an endpoint's budget — you may still hit `429`; the retry
+path handles that.
 
 Every method also accepts a per-call `timeout` (seconds or an `httpx.Timeout`) when one
 endpoint needs longer than the client default:

{blitz_api_py-0.4.0 → blitz_api_py-1.0.0}/README.md

@@ -168,8 +168,8 @@ All methods are grouped into four namespaces:
 | --- | --- |
 | `client.account` | `key_info()` |
 | `client.search` | `people()`, `companies()`, `employee_finder()`, `waterfall_icp()` |
-| `client.enrichment` | `email()`, `phone()`, `email_to_person()`, `phone_to_person()`, `company()`, `domain_to_linkedin()`, `linkedin_to_domain()` |
-| `client.utils` | `current_date()`, `company_employment_distribution()`, `company_department_distribution()` |
+| `client.enrichment` | `email()`, `phone()`, `email_to_person()`, `phone_to_person()`, `company()`, `domain_to_linkedin()`, `linkedin_to_domain()`, `company_distribution_by_country()`, `company_distribution_by_department()` |
+| `client.utils` | `current_date()` |
 
 Every method returns a typed Pydantic model (see `blitz_api.types`). Enum-backed
 filter fields (e.g. `Industry`, `JobLevel`, `Continent`) accept either an enum
@@ -227,10 +227,13 @@ client = BlitzAPI(
 ```
 
 The client-side rate limiter is a sliding window — at most `rate_limit_rps` requests
-in any rolling second — so a single client instance stays under the API's limit (5 req/s
-by default; check your key's limit via
-`client.account.key_info().max_requests_per_seconds`). Across multiple processes you may
-still hit `429` — the retry path handles that.
+in any rolling second — applied **per endpoint**: each endpoint (e.g. `.email` vs
+`.phone`) is throttled independently, mirroring the API's own limit, which is also per
+endpoint (5 req/s by default; check yours via
+`client.account.key_info().max_requests_per_seconds`). A single client instance therefore
+stays under the limit on every endpoint, so a burst on one never blocks another. Across
+multiple processes — which share an endpoint's budget — you may still hit `429`; the retry
+path handles that.
 
 Every method also accepts a per-call `timeout` (seconds or an `httpx.Timeout`) when one
 endpoint needs longer than the client default:

{blitz_api_py-0.4.0 → blitz_api_py-1.0.0}/src/blitz_api/_client_async.py

@@ -50,13 +50,34 @@ class AsyncBlitzAPI(BaseClient):
             )
         self._http_client = http_client or httpx.AsyncClient(timeout=timeout)
         self._owns_http_client = http_client is None
-        self._rate_limiter = AsyncRateLimiter(rate_limit_rps)
+        self._rate_limit_rps = rate_limit_rps
+        # One limiter per endpoint path so each endpoint's rate limit is tracked
+        # independently (e.g. ``.email`` and ``.phone`` do not share a budget). Built
+        # lazily in ``_limiter_for`` on first use of each path.
+        self._rate_limiters: dict[str, AsyncRateLimiter] = {}
         if sleep is None:
             import asyncio
 
             sleep = asyncio.sleep
         self._sleep = sleep
 
+    def _limiter_for(self, path: str) -> AsyncRateLimiter:
+        """Return the per-endpoint limiter for ``path``, creating it on first use.
+
+        Each endpoint path gets its own sliding window so its rate limit is tracked
+        independently of every other endpoint.
+        """
+        limiter = self._rate_limiters.get(path)
+        if limiter is None:
+            # ``setdefault`` keeps concurrent first-callers on the same instance; any
+            # extra limiter built in a race is harmlessly discarded. Thread the client's
+            # ``sleep`` through so a custom/fake sleep injected for tests also drives the
+            # limiter's throttle wait, not just the retry backoff.
+            limiter = self._rate_limiters.setdefault(
+                path, AsyncRateLimiter(self._rate_limit_rps, sleep=self._sleep)
+            )
+        return limiter
+
     async def _request(
         self,
         method: str,
@@ -72,7 +93,7 @@ class AsyncBlitzAPI(BaseClient):
 
         attempt = 0
         while True:
-            await self._rate_limiter.acquire()
+            await self._limiter_for(path).acquire()
             try:
                 if timeout is None:
                     response = await self._http_client.request(

{blitz_api_py-0.4.0 → blitz_api_py-1.0.0}/src/blitz_api/_client_sync.py

@@ -52,13 +52,34 @@ class BlitzAPI(BaseClient):
             )
         self._http_client = http_client or httpx.Client(timeout=timeout)
         self._owns_http_client = http_client is None
-        self._rate_limiter = RateLimiter(rate_limit_rps)
+        self._rate_limit_rps = rate_limit_rps
+        # One limiter per endpoint path so each endpoint's rate limit is tracked
+        # independently (e.g. ``.email`` and ``.phone`` do not share a budget). Built
+        # lazily in ``_limiter_for`` on first use of each path.
+        self._rate_limiters: dict[str, RateLimiter] = {}
         if sleep is None:
             import time
 
             sleep = time.sleep
         self._sleep = sleep
 
+    def _limiter_for(self, path: str) -> RateLimiter:
+        """Return the per-endpoint limiter for ``path``, creating it on first use.
+
+        Each endpoint path gets its own sliding window so its rate limit is tracked
+        independently of every other endpoint.
+        """
+        limiter = self._rate_limiters.get(path)
+        if limiter is None:
+            # ``setdefault`` keeps concurrent first-callers on the same instance; any
+            # extra limiter built in a race is harmlessly discarded. Thread the client's
+            # ``sleep`` through so a custom/fake sleep injected for tests also drives the
+            # limiter's throttle wait, not just the retry backoff.
+            limiter = self._rate_limiters.setdefault(
+                path, RateLimiter(self._rate_limit_rps, sleep=self._sleep)
+            )
+        return limiter
+
     def _request(
         self,
         method: str,
@@ -74,7 +95,7 @@ class BlitzAPI(BaseClient):
 
         attempt = 0
         while True:
-            self._rate_limiter.acquire()
+            self._limiter_for(path).acquire()
             try:
                 if timeout is None:
                     response = self._http_client.request(

{blitz_api_py-0.4.0 → blitz_api_py-1.0.0}/src/blitz_api/_rate_limit_async.py

@@ -1,9 +1,11 @@
 """Client-side sliding-window rate limiter (async source; sync twin generated).
 
-The API enforces a per-key request rate (5 req/s by default). This limiter throttles
-outgoing requests *before* they are sent so a single client instance stays under the
-limit proactively; the server-side 429 retry path is the backstop for bursts across
-processes.
+The API enforces a per-endpoint request rate (5 req/s by default). This limiter throttles
+outgoing requests *before* they are sent. The client holds one limiter **per endpoint
+path** (see ``_client_async.py``), so each endpoint is throttled to ``rps`` independently,
+mirroring the server's per-endpoint budget; a single client instance therefore stays under
+the limit on every endpoint on its own. The server-side 429 retry path is the backstop for
+bursts across processes, which share the same per-endpoint budget.
 
 The algorithm is a sliding window: at most ``rps`` requests may begin in any rolling
 one-second window. This matches the Blitz docs ("max 5 requests per 1000 ms") and the

{blitz_api_py-0.4.0 → blitz_api_py-1.0.0}/src/blitz_api/_rate_limit_sync.py

@@ -2,10 +2,12 @@
 # Do not edit by hand — edit the async source and run `python scripts/gen_sync.py`.
 """Client-side sliding-window rate limiter (async source; sync twin generated).
 
-The API enforces a per-key request rate (5 req/s by default). This limiter throttles
-outgoing requests *before* they are sent so a single client instance stays under the
-limit proactively; the server-side 429 retry path is the backstop for bursts across
-processes.
+The API enforces a per-endpoint request rate (5 req/s by default). This limiter throttles
+outgoing requests *before* they are sent. The client holds one limiter **per endpoint
+path** (see ``_client_async.py``), so each endpoint is throttled to ``rps`` independently,
+mirroring the server's per-endpoint budget; a single client instance therefore stays under
+the limit on every endpoint on its own. The server-side 429 retry path is the backstop for
+bursts across processes, which share the same per-endpoint budget.
 
 The algorithm is a sliding window: at most ``rps`` requests may begin in any rolling
 one-second window. This matches the Blitz docs ("max 5 requests per 1000 ms") and the

blitz_api_py-1.0.0/src/blitz_api/_version.py

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

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

@@ -6,6 +6,8 @@ from typing import TYPE_CHECKING
 
 from ..._compat import TimeoutParam
 from ...types.enrichment import (
+    CompanyCountryDistributionResponse,
+    CompanyDepartmentDistributionResponse,
     CompanyEnrichmentResponse,
     DomainToLinkedinResponse,
     EmailEnrichmentResponse,
@@ -25,6 +27,8 @@ _PHONE_TO_PERSON = "/v2/enrichment/phone-to-person"
 _COMPANY = "/v2/enrichment/company"
 _DOMAIN_TO_LINKEDIN = "/v2/enrichment/domain-to-linkedin"
 _LINKEDIN_TO_DOMAIN = "/v2/enrichment/linkedin-to-domain"
+_DISTRIBUTION_BY_COUNTRY = "/v2/enrichment/company-distribution-by-country"
+_DISTRIBUTION_BY_DEPARTMENT = "/v2/enrichment/company-distribution-by-department"
 
 
 class AsyncEnrichmentResource:
@@ -114,3 +118,34 @@ class AsyncEnrichmentResource:
             cast_to=LinkedinToDomainResponse,
             timeout=timeout,
         )
+
+    async def company_distribution_by_country(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> CompanyCountryDistributionResponse:
+        """Get a company's employee count broken down by country.
+
+        Countries are reported as ISO 3166-1 alpha-2 codes (e.g. ``US``, ``GB``);
+        employees whose country can't be determined are bucketed under ``"unknown"``.
+        """
+        return await self._client._request(
+            "POST",
+            _DISTRIBUTION_BY_COUNTRY,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=CompanyCountryDistributionResponse,
+            timeout=timeout,
+        )
+
+    async def company_distribution_by_department(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> CompanyDepartmentDistributionResponse:
+        """Get a company's employee count broken down by department.
+
+        Employees with no classified department are counted under ``"Other"``.
+        """
+        return await self._client._request(
+            "POST",
+            _DISTRIBUTION_BY_DEPARTMENT,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=CompanyDepartmentDistributionResponse,
+            timeout=timeout,
+        )

blitz_api_py-1.0.0/src/blitz_api/resources/_async/utils.py

@@ -0,0 +1,30 @@
+"""The Utilities resource: ``client.utils``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..._compat import TimeoutParam
+from ...types.utils import CurrentDateResponse
+
+if TYPE_CHECKING:
+    from ..._client import AsyncBlitzAPI
+
+_CURRENT_DATE = "/v2/utils/current-date"
+
+
+class AsyncUtilsResource:
+    def __init__(self, client: AsyncBlitzAPI) -> None:
+        self._client = client
+
+    async def current_date(
+        self, *, region: str, timeout: TimeoutParam = None
+    ) -> CurrentDateResponse:
+        """Get the current server date/time for an IANA timezone (e.g. ``America/New_York``)."""
+        return await self._client._request(
+            "POST",
+            _CURRENT_DATE,
+            body={"region": region},
+            cast_to=CurrentDateResponse,
+            timeout=timeout,
+        )

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

@@ -8,6 +8,8 @@ from typing import TYPE_CHECKING
 
 from ..._compat import TimeoutParam
 from ...types.enrichment import (
+    CompanyCountryDistributionResponse,
+    CompanyDepartmentDistributionResponse,
     CompanyEnrichmentResponse,
     DomainToLinkedinResponse,
     EmailEnrichmentResponse,
@@ -27,6 +29,8 @@ _PHONE_TO_PERSON = "/v2/enrichment/phone-to-person"
 _COMPANY = "/v2/enrichment/company"
 _DOMAIN_TO_LINKEDIN = "/v2/enrichment/domain-to-linkedin"
 _LINKEDIN_TO_DOMAIN = "/v2/enrichment/linkedin-to-domain"
+_DISTRIBUTION_BY_COUNTRY = "/v2/enrichment/company-distribution-by-country"
+_DISTRIBUTION_BY_DEPARTMENT = "/v2/enrichment/company-distribution-by-department"
 
 
 class EnrichmentResource:
@@ -116,3 +120,34 @@ class EnrichmentResource:
             cast_to=LinkedinToDomainResponse,
             timeout=timeout,
         )
+
+    def company_distribution_by_country(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> CompanyCountryDistributionResponse:
+        """Get a company's employee count broken down by country.
+
+        Countries are reported as ISO 3166-1 alpha-2 codes (e.g. ``US``, ``GB``);
+        employees whose country can't be determined are bucketed under ``"unknown"``.
+        """
+        return self._client._request(
+            "POST",
+            _DISTRIBUTION_BY_COUNTRY,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=CompanyCountryDistributionResponse,
+            timeout=timeout,
+        )
+
+    def company_distribution_by_department(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> CompanyDepartmentDistributionResponse:
+        """Get a company's employee count broken down by department.
+
+        Employees with no classified department are counted under ``"Other"``.
+        """
+        return self._client._request(
+            "POST",
+            _DISTRIBUTION_BY_DEPARTMENT,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=CompanyDepartmentDistributionResponse,
+            timeout=timeout,
+        )

blitz_api_py-1.0.0/src/blitz_api/resources/_sync/utils.py

@@ -0,0 +1,32 @@
+# This file is @generated by scripts/gen_sync.py from src/blitz_api/resources/_async/utils.py.
+# Do not edit by hand — edit the async source and run `python scripts/gen_sync.py`.
+"""The Utilities resource: ``client.utils``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..._compat import TimeoutParam
+from ...types.utils import CurrentDateResponse
+
+if TYPE_CHECKING:
+    from ..._client import BlitzAPI
+
+_CURRENT_DATE = "/v2/utils/current-date"
+
+
+class UtilsResource:
+    def __init__(self, client: BlitzAPI) -> None:
+        self._client = client
+
+    def current_date(
+        self, *, region: str, timeout: TimeoutParam = None
+    ) -> CurrentDateResponse:
+        """Get the current server date/time for an IANA timezone (e.g. ``America/New_York``)."""
+        return self._client._request(
+            "POST",
+            _CURRENT_DATE,
+            body={"region": region},
+            cast_to=CurrentDateResponse,
+            timeout=timeout,
+        )

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

@@ -9,7 +9,11 @@ from __future__ import annotations
 
 from .account import ActivePlan, KeyInfo
 from .enrichment import (
+    CompanyCountryDistributionResponse,
+    CompanyDepartmentDistributionResponse,
     CompanyEnrichmentResponse,
+    CountryDistributionItem,
+    DepartmentDistributionItem,
     DomainToLinkedinResponse,
     EmailEnrichmentResponse,
     EmailMatch,
@@ -22,6 +26,7 @@ from .enums import (
     CompanyType,
     Continent,
     EmployeeRange,
+    FundingType,
     Industry,
     JobFunction,
     JobLevel,
@@ -32,6 +37,7 @@ from .filters import (
     CompanyFilter,
     CompanyHQFilter,
     CompanyTypeFilter,
+    FundingTypeFilter,
     IndustryFilter,
     KeywordFilter,
     PeopleFilter,
@@ -53,11 +59,7 @@ from .shared import (
     Person,
 )
 from .utils import (
-    CompanyDepartmentDistributionResponse,
-    CompanyEmploymentDistributionResponse,
     CurrentDateResponse,
-    DepartmentDistributionItem,
-    EmploymentDistributionItem,
 )
 
 __all__ = [
@@ -73,6 +75,7 @@ __all__ = [
     "Industry",
     "CompanyType",
     "EmployeeRange",
+    "FundingType",
     "Continent",
     "SalesRegion",
     "JobFunction",
@@ -81,6 +84,7 @@ __all__ = [
     "KeywordFilter",
     "IndustryFilter",
     "CompanyTypeFilter",
+    "FundingTypeFilter",
     "RangeFilter",
     "CompanyHQFilter",
     "CompanyFilter",
@@ -103,10 +107,10 @@ __all__ = [
     "CompanyEnrichmentResponse",
     "DomainToLinkedinResponse",
     "LinkedinToDomainResponse",
-    # utils
-    "CurrentDateResponse",
-    "EmploymentDistributionItem",
-    "CompanyEmploymentDistributionResponse",
+    "CountryDistributionItem",
+    "CompanyCountryDistributionResponse",
     "DepartmentDistributionItem",
     "CompanyDepartmentDistributionResponse",
+    # utils
+    "CurrentDateResponse",
 ]

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

@@ -14,6 +14,10 @@ __all__ = [
     "CompanyEnrichmentResponse",
     "DomainToLinkedinResponse",
     "LinkedinToDomainResponse",
+    "CountryDistributionItem",
+    "CompanyCountryDistributionResponse",
+    "DepartmentDistributionItem",
+    "CompanyDepartmentDistributionResponse",
 ]
 
 
@@ -74,3 +78,52 @@ class LinkedinToDomainResponse(BlitzModel):
 
     found: bool | None = None
     email_domain: str | None = None
+
+
+class CountryDistributionItem(BlitzModel):
+    """Employee count for a single country.
+
+    ``country`` is an ISO 3166-1 alpha-2 code (e.g. ``"US"``, ``"GB"``), or the
+    literal ``"unknown"`` bucket for employees whose country couldn't be determined.
+    ``percentage_ratio`` is the bucket's share of ``total_employees`` (0-100, to 2
+    decimals).
+    """
+
+    country: str | None = None
+    count: int | None = None
+    percentage_ratio: float | None = None
+
+
+class CompanyCountryDistributionResponse(BlitzModel):
+    """Result of ``enrichment.company_distribution_by_country``.
+
+    Served by ``POST /v2/enrichment/company-distribution-by-country``.
+    """
+
+    company_linkedin_url: str | None = None
+    total_employees: int | None = None
+    distribution: list[CountryDistributionItem] = []
+
+
+class DepartmentDistributionItem(BlitzModel):
+    """Employee count for a single department (Blitz job function).
+
+    Employees with no classified department are counted under ``"Other"``.
+    ``percentage_ratio`` is the bucket's share of ``total_employees`` (0-100, to 2
+    decimals).
+    """
+
+    department: str | None = None
+    count: int | None = None
+    percentage_ratio: float | None = None
+
+
+class CompanyDepartmentDistributionResponse(BlitzModel):
+    """Result of ``enrichment.company_distribution_by_department``.
+
+    Served by ``POST /v2/enrichment/company-distribution-by-department``.
+    """
+
+    company_linkedin_url: str | None = None
+    total_employees: int | None = None
+    distribution: list[DepartmentDistributionItem] = []

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

@@ -18,6 +18,7 @@ __all__ = [
     "SalesRegion",
     "JobFunction",
     "JobLevel",
+    "FundingType",
 ]
 
 
@@ -631,3 +632,29 @@ class JobLevel(str, Enum):
     OTHER = 'Other'
     STAFF = 'Staff'
     VP = 'VP'
+
+
+class FundingType(str, Enum):
+    SERIES_UNKNOWN = 'Series unknown'
+    PRE_SEED = 'Pre seed'
+    SEED = 'Seed'
+    SERIES_A = 'Series A'
+    SERIES_B = 'Series B'
+    SERIES_C = 'Series C'
+    SERIES_D = 'Series D'
+    SERIES_E_J = 'Series E-J'
+    GRANT = 'Grant'
+    ANGEL = 'Angel'
+    PRIVATE_EQUITY = 'Private equity'
+    DEBT_FINANCING = 'Debt financing'
+    NON_EQUITY_ASSISTANCE = 'Non equity assistance'
+    POST_IPO_EQUITY = 'Post IPO equity'
+    UNDISCLOSED = 'Undisclosed'
+    POST_IPO_DEBT = 'Post IPO debt'
+    PRODUCT_CROWDFUNDING = 'Product crowdfunding'
+    EQUITY_CROWDFUNDING = 'Equity crowdfunding'
+    CORPORATE_ROUND = 'Corporate round'
+    CONVERTIBLE_NOTE = 'Convertible note'
+    SECONDARY_MARKET = 'Secondary market'
+    INITIAL_COIN_OFFERING = 'Initial coin offering'
+    POST_IPO_SECONDARY = 'Post IPO secondary'

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

@@ -16,6 +16,7 @@ from .enums import (
     CompanyType,
     Continent,
     EmployeeRange,
+    FundingType,
     Industry,
     JobFunction,
     JobLevel,
@@ -30,6 +31,7 @@ from .enums import (
 IndustryValue = Industry | str
 CompanyTypeValue = CompanyType | str
 EmployeeRangeValue = EmployeeRange | str
+FundingTypeValue = FundingType | str
 ContinentValue = Continent | str
 SalesRegionValue = SalesRegion | str
 JobFunctionValue = JobFunction | str
@@ -57,6 +59,13 @@ class CompanyTypeFilter(TypedDict, total=False):
     exclude: list[CompanyTypeValue]
 
 
+class FundingTypeFilter(TypedDict, total=False):
+    """Include/exclude filter over the last funding round type."""
+
+    include: list[FundingTypeValue]
+    exclude: list[FundingTypeValue]
+
+
 class RangeFilter(TypedDict, total=False):
     """Numeric range filter. ``0`` means unset for most fields."""
 
@@ -68,6 +77,7 @@ class CompanyHQFilter(TypedDict, total=False):
     """Headquarters-location filter for company search."""
 
     city: KeywordFilter
+    state: KeywordFilter
     country_code: list[str]
     continent: list[ContinentValue]
     sales_region: list[SalesRegionValue]
@@ -88,6 +98,11 @@ class CompanyFilter(TypedDict, total=False):
     sic_code: KeywordFilter
     web_traffic: RangeFilter
     ad_spend: RangeFilter
+    total_funding: RangeFilter
+    last_funding_amount: RangeFilter
+    last_funding_year: RangeFilter
+    last_funding_type: FundingTypeFilter
+    lead_investors: KeywordFilter
     keywords: KeywordFilter
     founded_year: RangeFilter
     hq: CompanyHQFilter

blitz_api_py-1.0.0/src/blitz_api/types/utils.py

@@ -0,0 +1,18 @@
+"""Response models for the Utilities resource."""
+
+from __future__ import annotations
+
+from ._models import BlitzModel
+
+__all__ = [
+    "CurrentDateResponse",
+]
+
+
+class CurrentDateResponse(BlitzModel):
+    """Result of ``utils.current_date``."""
+
+    datetime: str | None = None
+    timestamp: int | None = None
+    timezone: str | None = None
+    timezone_name: str | None = None

blitz_api_py-0.4.0/src/blitz_api/_version.py

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

blitz_api_py-0.4.0/src/blitz_api/resources/_async/utils.py

@@ -1,63 +0,0 @@
-"""The Utilities resource: ``client.utils``."""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-from ..._compat import TimeoutParam
-from ...types.utils import (
-    CompanyDepartmentDistributionResponse,
-    CompanyEmploymentDistributionResponse,
-    CurrentDateResponse,
-)
-
-if TYPE_CHECKING:
-    from ..._client import AsyncBlitzAPI
-
-_CURRENT_DATE = "/v2/utils/current-date"
-_EMPLOYMENT_DISTRIBUTION = "/v2/utils/company-employment-distribution"
-_DEPARTMENT_DISTRIBUTION = "/v2/utils/company-department-distribution"
-
-
-class AsyncUtilsResource:
-    def __init__(self, client: AsyncBlitzAPI) -> None:
-        self._client = client
-
-    async def current_date(
-        self, *, region: str, timeout: TimeoutParam = None
-    ) -> CurrentDateResponse:
-        """Get the current server date/time for an IANA timezone (e.g. ``America/New_York``)."""
-        return await self._client._request(
-            "POST",
-            _CURRENT_DATE,
-            body={"region": region},
-            cast_to=CurrentDateResponse,
-            timeout=timeout,
-        )
-
-    async def company_employment_distribution(
-        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyEmploymentDistributionResponse:
-        """Get a company's employee count broken down by country."""
-        return await self._client._request(
-            "POST",
-            _EMPLOYMENT_DISTRIBUTION,
-            body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyEmploymentDistributionResponse,
-            timeout=timeout,
-        )
-
-    async def company_department_distribution(
-        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyDepartmentDistributionResponse:
-        """Get a company's employee count broken down by department.
-
-        Employees with no classified department are counted under ``"Other"``.
-        """
-        return await self._client._request(
-            "POST",
-            _DEPARTMENT_DISTRIBUTION,
-            body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyDepartmentDistributionResponse,
-            timeout=timeout,
-        )

blitz_api_py-0.4.0/src/blitz_api/resources/_sync/utils.py

@@ -1,65 +0,0 @@
-# This file is @generated by scripts/gen_sync.py from src/blitz_api/resources/_async/utils.py.
-# Do not edit by hand — edit the async source and run `python scripts/gen_sync.py`.
-"""The Utilities resource: ``client.utils``."""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-from ..._compat import TimeoutParam
-from ...types.utils import (
-    CompanyDepartmentDistributionResponse,
-    CompanyEmploymentDistributionResponse,
-    CurrentDateResponse,
-)
-
-if TYPE_CHECKING:
-    from ..._client import BlitzAPI
-
-_CURRENT_DATE = "/v2/utils/current-date"
-_EMPLOYMENT_DISTRIBUTION = "/v2/utils/company-employment-distribution"
-_DEPARTMENT_DISTRIBUTION = "/v2/utils/company-department-distribution"
-
-
-class UtilsResource:
-    def __init__(self, client: BlitzAPI) -> None:
-        self._client = client
-
-    def current_date(
-        self, *, region: str, timeout: TimeoutParam = None
-    ) -> CurrentDateResponse:
-        """Get the current server date/time for an IANA timezone (e.g. ``America/New_York``)."""
-        return self._client._request(
-            "POST",
-            _CURRENT_DATE,
-            body={"region": region},
-            cast_to=CurrentDateResponse,
-            timeout=timeout,
-        )
-
-    def company_employment_distribution(
-        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyEmploymentDistributionResponse:
-        """Get a company's employee count broken down by country."""
-        return self._client._request(
-            "POST",
-            _EMPLOYMENT_DISTRIBUTION,
-            body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyEmploymentDistributionResponse,
-            timeout=timeout,
-        )
-
-    def company_department_distribution(
-        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
-    ) -> CompanyDepartmentDistributionResponse:
-        """Get a company's employee count broken down by department.
-
-        Employees with no classified department are counted under ``"Other"``.
-        """
-        return self._client._request(
-            "POST",
-            _DEPARTMENT_DISTRIBUTION,
-            body={"company_linkedin_url": company_linkedin_url},
-            cast_to=CompanyDepartmentDistributionResponse,
-            timeout=timeout,
-        )

blitz_api_py-0.4.0/src/blitz_api/types/utils.py

@@ -1,55 +0,0 @@
-"""Response models for the Utilities resource."""
-
-from __future__ import annotations
-
-from ._models import BlitzModel
-
-__all__ = [
-    "CurrentDateResponse",
-    "EmploymentDistributionItem",
-    "CompanyEmploymentDistributionResponse",
-    "DepartmentDistributionItem",
-    "CompanyDepartmentDistributionResponse",
-]
-
-
-class CurrentDateResponse(BlitzModel):
-    """Result of ``utils.current_date``."""
-
-    datetime: str | None = None
-    timestamp: int | None = None
-    timezone: str | None = None
-    timezone_name: str | None = None
-
-
-class EmploymentDistributionItem(BlitzModel):
-    """Employee count for a single country."""
-
-    country: str | None = None
-    count: int | None = None
-
-
-class CompanyEmploymentDistributionResponse(BlitzModel):
-    """Result of ``utils.company_employment_distribution``."""
-
-    company_linkedin_url: str | None = None
-    total_employees: int | None = None
-    distribution: list[EmploymentDistributionItem] = []
-
-
-class DepartmentDistributionItem(BlitzModel):
-    """Employee count for a single department (Blitz job function).
-
-    Employees with no classified department are counted under ``"Other"``.
-    """
-
-    department: str | None = None
-    count: int | None = None
-
-
-class CompanyDepartmentDistributionResponse(BlitzModel):
-    """Result of ``utils.company_department_distribution``."""
-
-    company_linkedin_url: str | None = None
-    total_employees: int | None = None
-    distribution: list[DepartmentDistributionItem] = []