blitz-api-py 0.1.0__py3-none-any.whl

blitz_api/resources/_async/enrichment.py

@@ -0,0 +1,116 @@
+"""The Enrichment resource: ``client.enrichment``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..._compat import TimeoutParam
+from ...types.enrichment import (
+    CompanyEnrichmentResponse,
+    DomainToLinkedinResponse,
+    EmailEnrichmentResponse,
+    EmailToPersonResponse,
+    LinkedinToDomainResponse,
+    PhoneEnrichmentResponse,
+    PhoneToPersonResponse,
+)
+
+if TYPE_CHECKING:
+    from ..._client import AsyncBlitzAPI
+
+_EMAIL = "/v2/enrichment/email"
+_PHONE = "/v2/enrichment/phone"
+_EMAIL_TO_PERSON = "/v2/enrichment/email-to-person"
+_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"
+
+
+class AsyncEnrichmentResource:
+    def __init__(self, client: AsyncBlitzAPI) -> None:
+        self._client = client
+
+    async def email(
+        self, *, person_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> EmailEnrichmentResponse:
+        """Find a verified work email from a LinkedIn profile URL."""
+        return await self._client._request(
+            "POST",
+            _EMAIL,
+            body={"person_linkedin_url": person_linkedin_url},
+            cast_to=EmailEnrichmentResponse,
+            timeout=timeout,
+        )
+
+    async def phone(
+        self, *, person_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> PhoneEnrichmentResponse:
+        """Find a phone number from a LinkedIn profile URL (US only)."""
+        return await self._client._request(
+            "POST",
+            _PHONE,
+            body={"person_linkedin_url": person_linkedin_url},
+            cast_to=PhoneEnrichmentResponse,
+            timeout=timeout,
+        )
+
+    async def email_to_person(
+        self, *, email: str, timeout: TimeoutParam = None
+    ) -> EmailToPersonResponse:
+        """Resolve a work email to a full person profile."""
+        return await self._client._request(
+            "POST",
+            _EMAIL_TO_PERSON,
+            body={"email": email},
+            cast_to=EmailToPersonResponse,
+            timeout=timeout,
+        )
+
+    async def phone_to_person(
+        self, *, phone: str, timeout: TimeoutParam = None
+    ) -> PhoneToPersonResponse:
+        """Resolve a phone number to a full person profile."""
+        return await self._client._request(
+            "POST",
+            _PHONE_TO_PERSON,
+            body={"phone": phone},
+            cast_to=PhoneToPersonResponse,
+            timeout=timeout,
+        )
+
+    async def company(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> CompanyEnrichmentResponse:
+        """Resolve a company LinkedIn URL to a full company profile."""
+        return await self._client._request(
+            "POST",
+            _COMPANY,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=CompanyEnrichmentResponse,
+            timeout=timeout,
+        )
+
+    async def domain_to_linkedin(
+        self, *, domain: str, timeout: TimeoutParam = None
+    ) -> DomainToLinkedinResponse:
+        """Resolve a website domain to a company LinkedIn URL."""
+        return await self._client._request(
+            "POST",
+            _DOMAIN_TO_LINKEDIN,
+            body={"domain": domain},
+            cast_to=DomainToLinkedinResponse,
+            timeout=timeout,
+        )
+
+    async def linkedin_to_domain(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> LinkedinToDomainResponse:
+        """Resolve a company LinkedIn URL to its email domain."""
+        return await self._client._request(
+            "POST",
+            _LINKEDIN_TO_DOMAIN,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=LinkedinToDomainResponse,
+            timeout=timeout,
+        )

blitz_api/resources/_async/search.py

@@ -0,0 +1,153 @@
+"""The Search resource: ``client.search``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from ..._compat import TimeoutParam
+from ..._pagination_async import AsyncCursorPage, AsyncPageNumberPage
+from ...types.filters import (
+    CascadeTier,
+    CompanyFilter,
+    ContinentValue,
+    JobFunctionValue,
+    JobLevelValue,
+    PeopleFilter,
+    SalesRegionValue,
+)
+from ...types.search import WaterfallIcpResponse
+from ...types.shared import Company, Person
+
+if TYPE_CHECKING:
+    from ..._client import AsyncBlitzAPI
+
+_PEOPLE = "/v2/search/people"
+_COMPANIES = "/v2/search/companies"
+_EMPLOYEE_FINDER = "/v2/search/employee-finder"
+_WATERFALL = "/v2/search/waterfall-icp-keyword"
+
+
+def _drop_none(**kwargs: Any) -> dict[str, Any]:
+    """Build a request body keeping only the arguments the caller provided."""
+    return {key: value for key, value in kwargs.items() if value is not None}
+
+
+def _employee_finder_body(
+    *,
+    company_linkedin_url: str,
+    country_code: list[str] | None,
+    continent: list[ContinentValue] | None,
+    sales_region: list[SalesRegionValue] | None,
+    job_level: list[JobLevelValue] | None,
+    job_function: list[JobFunctionValue] | None,
+    min_connections_count: int | None,
+    max_results: int | None,
+    page: int | None,
+) -> dict[str, Any]:
+    return _drop_none(
+        company_linkedin_url=company_linkedin_url,
+        country_code=country_code,
+        continent=continent,
+        sales_region=sales_region,
+        job_level=job_level,
+        job_function=job_function,
+        min_connections_count=min_connections_count,
+        max_results=max_results,
+        page=page,
+    )
+
+
+class AsyncSearchResource:
+    def __init__(self, client: AsyncBlitzAPI) -> None:
+        self._client = client
+
+    async def people(
+        self,
+        *,
+        company: CompanyFilter | None = None,
+        people: PeopleFilter | None = None,
+        max_results: int | None = None,
+        cursor: str | None = None,
+        timeout: TimeoutParam = None,
+    ) -> AsyncCursorPage[Person]:
+        """Search people across many companies, combining company and persona filters.
+
+        Auto-paginates over every matching person when the result is iterated; use
+        ``.iter_pages()`` or the ``cursor=`` arg for manual control.
+        """
+        body = _drop_none(company=company, people=people, max_results=max_results, cursor=cursor)
+        return await self._client._request(
+            "POST", _PEOPLE, body=body, cast_to=AsyncCursorPage[Person], timeout=timeout
+        )
+
+    async def companies(
+        self,
+        *,
+        company: CompanyFilter | None = None,
+        max_results: int | None = None,
+        cursor: str | None = None,
+        timeout: TimeoutParam = None,
+    ) -> AsyncCursorPage[Company]:
+        """Find companies matching ICP filters (industry, size, HQ, revenue, ...).
+
+        Auto-paginates over every matching company; use ``.iter_pages()`` or ``cursor=``
+        for manual control.
+        """
+        body = _drop_none(company=company, max_results=max_results, cursor=cursor)
+        return await self._client._request(
+            "POST", _COMPANIES, body=body, cast_to=AsyncCursorPage[Company], timeout=timeout
+        )
+
+    async def employee_finder(
+        self,
+        *,
+        company_linkedin_url: str,
+        country_code: list[str] | None = None,
+        continent: list[ContinentValue] | None = None,
+        sales_region: list[SalesRegionValue] | None = None,
+        job_level: list[JobLevelValue] | None = None,
+        job_function: list[JobFunctionValue] | None = None,
+        min_connections_count: int | None = None,
+        max_results: int | None = None,
+        page: int | None = None,
+        timeout: TimeoutParam = None,
+    ) -> AsyncPageNumberPage[Person]:
+        """Search employees at a single company, with page-based pagination.
+
+        Auto-paginates over every matching employee; use ``.iter_pages()`` or ``page=``
+        for manual control.
+        """
+        body = _employee_finder_body(
+            company_linkedin_url=company_linkedin_url,
+            country_code=country_code,
+            continent=continent,
+            sales_region=sales_region,
+            job_level=job_level,
+            job_function=job_function,
+            min_connections_count=min_connections_count,
+            max_results=max_results,
+            page=page,
+        )
+        return await self._client._request(
+            "POST",
+            _EMPLOYEE_FINDER,
+            body=body,
+            cast_to=AsyncPageNumberPage[Person],
+            timeout=timeout,
+        )
+
+    async def waterfall_icp(
+        self,
+        *,
+        company_linkedin_url: str,
+        cascade: list[CascadeTier],
+        max_results: int | None = None,
+        timeout: TimeoutParam = None,
+    ) -> WaterfallIcpResponse:
+        """Find the best decision-maker at a company via a prioritized cascade."""
+        body = _drop_none(
+            company_linkedin_url=company_linkedin_url, cascade=cascade, max_results=max_results
+        )
+        return await self._client._request(
+            "POST", _WATERFALL, body=body, cast_to=WaterfallIcpResponse, timeout=timeout
+        )

blitz_api/resources/_async/utils.py

@@ -0,0 +1,43 @@
+"""The Utilities resource: ``client.utils``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..._compat import TimeoutParam
+from ...types.utils import CompanyEmploymentDistributionResponse, CurrentDateResponse
+
+if TYPE_CHECKING:
+    from ..._client import AsyncBlitzAPI
+
+_CURRENT_DATE = "/v2/utils/current-date"
+_EMPLOYMENT_DISTRIBUTION = "/v2/utils/company-employment-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,
+        )

blitz_api/resources/_sync/__init__.py

@@ -0,0 +1,3 @@
+# This file is @generated by scripts/gen_sync.py from src/blitz_api/resources/_async/__init__.py.
+# Do not edit by hand — edit the async source and run `python scripts/gen_sync.py`.
+"""Blitz API resource classes, grouped by the API's OpenAPI tags."""

blitz_api/resources/_sync/account.py

@@ -0,0 +1,29 @@
+# This file is @generated by scripts/gen_sync.py from src/blitz_api/resources/_async/account.py.
+# Do not edit by hand — edit the async source and run `python scripts/gen_sync.py`.
+"""The Account resource: ``client.account``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..._compat import TimeoutParam
+from ...types.account import KeyInfo
+
+if TYPE_CHECKING:
+    from ..._client import BlitzAPI
+
+_KEY_INFO_PATH = "/v2/account/key-info"
+
+
+class AccountResource:
+    def __init__(self, client: BlitzAPI) -> None:
+        self._client = client
+
+    def key_info(self, *, timeout: TimeoutParam = None) -> KeyInfo:
+        """Check the API key's validity, credit balance, and rate limit.
+
+        A cheap health check to run before a batch job.
+        """
+        return self._client._request(
+            "GET", _KEY_INFO_PATH, body=None, cast_to=KeyInfo, timeout=timeout
+        )

blitz_api/resources/_sync/enrichment.py

@@ -0,0 +1,118 @@
+# This file is @generated by scripts/gen_sync.py from src/blitz_api/resources/_async/enrichment.py.
+# Do not edit by hand — edit the async source and run `python scripts/gen_sync.py`.
+"""The Enrichment resource: ``client.enrichment``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..._compat import TimeoutParam
+from ...types.enrichment import (
+    CompanyEnrichmentResponse,
+    DomainToLinkedinResponse,
+    EmailEnrichmentResponse,
+    EmailToPersonResponse,
+    LinkedinToDomainResponse,
+    PhoneEnrichmentResponse,
+    PhoneToPersonResponse,
+)
+
+if TYPE_CHECKING:
+    from ..._client import BlitzAPI
+
+_EMAIL = "/v2/enrichment/email"
+_PHONE = "/v2/enrichment/phone"
+_EMAIL_TO_PERSON = "/v2/enrichment/email-to-person"
+_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"
+
+
+class EnrichmentResource:
+    def __init__(self, client: BlitzAPI) -> None:
+        self._client = client
+
+    def email(
+        self, *, person_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> EmailEnrichmentResponse:
+        """Find a verified work email from a LinkedIn profile URL."""
+        return self._client._request(
+            "POST",
+            _EMAIL,
+            body={"person_linkedin_url": person_linkedin_url},
+            cast_to=EmailEnrichmentResponse,
+            timeout=timeout,
+        )
+
+    def phone(
+        self, *, person_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> PhoneEnrichmentResponse:
+        """Find a phone number from a LinkedIn profile URL (US only)."""
+        return self._client._request(
+            "POST",
+            _PHONE,
+            body={"person_linkedin_url": person_linkedin_url},
+            cast_to=PhoneEnrichmentResponse,
+            timeout=timeout,
+        )
+
+    def email_to_person(
+        self, *, email: str, timeout: TimeoutParam = None
+    ) -> EmailToPersonResponse:
+        """Resolve a work email to a full person profile."""
+        return self._client._request(
+            "POST",
+            _EMAIL_TO_PERSON,
+            body={"email": email},
+            cast_to=EmailToPersonResponse,
+            timeout=timeout,
+        )
+
+    def phone_to_person(
+        self, *, phone: str, timeout: TimeoutParam = None
+    ) -> PhoneToPersonResponse:
+        """Resolve a phone number to a full person profile."""
+        return self._client._request(
+            "POST",
+            _PHONE_TO_PERSON,
+            body={"phone": phone},
+            cast_to=PhoneToPersonResponse,
+            timeout=timeout,
+        )
+
+    def company(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> CompanyEnrichmentResponse:
+        """Resolve a company LinkedIn URL to a full company profile."""
+        return self._client._request(
+            "POST",
+            _COMPANY,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=CompanyEnrichmentResponse,
+            timeout=timeout,
+        )
+
+    def domain_to_linkedin(
+        self, *, domain: str, timeout: TimeoutParam = None
+    ) -> DomainToLinkedinResponse:
+        """Resolve a website domain to a company LinkedIn URL."""
+        return self._client._request(
+            "POST",
+            _DOMAIN_TO_LINKEDIN,
+            body={"domain": domain},
+            cast_to=DomainToLinkedinResponse,
+            timeout=timeout,
+        )
+
+    def linkedin_to_domain(
+        self, *, company_linkedin_url: str, timeout: TimeoutParam = None
+    ) -> LinkedinToDomainResponse:
+        """Resolve a company LinkedIn URL to its email domain."""
+        return self._client._request(
+            "POST",
+            _LINKEDIN_TO_DOMAIN,
+            body={"company_linkedin_url": company_linkedin_url},
+            cast_to=LinkedinToDomainResponse,
+            timeout=timeout,
+        )

blitz_api/resources/_sync/search.py

@@ -0,0 +1,155 @@
+# This file is @generated by scripts/gen_sync.py from src/blitz_api/resources/_async/search.py.
+# Do not edit by hand — edit the async source and run `python scripts/gen_sync.py`.
+"""The Search resource: ``client.search``."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from ..._compat import TimeoutParam
+from ..._pagination_sync import CursorPage, PageNumberPage
+from ...types.filters import (
+    CascadeTier,
+    CompanyFilter,
+    ContinentValue,
+    JobFunctionValue,
+    JobLevelValue,
+    PeopleFilter,
+    SalesRegionValue,
+)
+from ...types.search import WaterfallIcpResponse
+from ...types.shared import Company, Person
+
+if TYPE_CHECKING:
+    from ..._client import BlitzAPI
+
+_PEOPLE = "/v2/search/people"
+_COMPANIES = "/v2/search/companies"
+_EMPLOYEE_FINDER = "/v2/search/employee-finder"
+_WATERFALL = "/v2/search/waterfall-icp-keyword"
+
+
+def _drop_none(**kwargs: Any) -> dict[str, Any]:
+    """Build a request body keeping only the arguments the caller provided."""
+    return {key: value for key, value in kwargs.items() if value is not None}
+
+
+def _employee_finder_body(
+    *,
+    company_linkedin_url: str,
+    country_code: list[str] | None,
+    continent: list[ContinentValue] | None,
+    sales_region: list[SalesRegionValue] | None,
+    job_level: list[JobLevelValue] | None,
+    job_function: list[JobFunctionValue] | None,
+    min_connections_count: int | None,
+    max_results: int | None,
+    page: int | None,
+) -> dict[str, Any]:
+    return _drop_none(
+        company_linkedin_url=company_linkedin_url,
+        country_code=country_code,
+        continent=continent,
+        sales_region=sales_region,
+        job_level=job_level,
+        job_function=job_function,
+        min_connections_count=min_connections_count,
+        max_results=max_results,
+        page=page,
+    )
+
+
+class SearchResource:
+    def __init__(self, client: BlitzAPI) -> None:
+        self._client = client
+
+    def people(
+        self,
+        *,
+        company: CompanyFilter | None = None,
+        people: PeopleFilter | None = None,
+        max_results: int | None = None,
+        cursor: str | None = None,
+        timeout: TimeoutParam = None,
+    ) -> CursorPage[Person]:
+        """Search people across many companies, combining company and persona filters.
+
+        Auto-paginates over every matching person when the result is iterated; use
+        ``.iter_pages()`` or the ``cursor=`` arg for manual control.
+        """
+        body = _drop_none(company=company, people=people, max_results=max_results, cursor=cursor)
+        return self._client._request(
+            "POST", _PEOPLE, body=body, cast_to=CursorPage[Person], timeout=timeout
+        )
+
+    def companies(
+        self,
+        *,
+        company: CompanyFilter | None = None,
+        max_results: int | None = None,
+        cursor: str | None = None,
+        timeout: TimeoutParam = None,
+    ) -> CursorPage[Company]:
+        """Find companies matching ICP filters (industry, size, HQ, revenue, ...).
+
+        Auto-paginates over every matching company; use ``.iter_pages()`` or ``cursor=``
+        for manual control.
+        """
+        body = _drop_none(company=company, max_results=max_results, cursor=cursor)
+        return self._client._request(
+            "POST", _COMPANIES, body=body, cast_to=CursorPage[Company], timeout=timeout
+        )
+
+    def employee_finder(
+        self,
+        *,
+        company_linkedin_url: str,
+        country_code: list[str] | None = None,
+        continent: list[ContinentValue] | None = None,
+        sales_region: list[SalesRegionValue] | None = None,
+        job_level: list[JobLevelValue] | None = None,
+        job_function: list[JobFunctionValue] | None = None,
+        min_connections_count: int | None = None,
+        max_results: int | None = None,
+        page: int | None = None,
+        timeout: TimeoutParam = None,
+    ) -> PageNumberPage[Person]:
+        """Search employees at a single company, with page-based pagination.
+
+        Auto-paginates over every matching employee; use ``.iter_pages()`` or ``page=``
+        for manual control.
+        """
+        body = _employee_finder_body(
+            company_linkedin_url=company_linkedin_url,
+            country_code=country_code,
+            continent=continent,
+            sales_region=sales_region,
+            job_level=job_level,
+            job_function=job_function,
+            min_connections_count=min_connections_count,
+            max_results=max_results,
+            page=page,
+        )
+        return self._client._request(
+            "POST",
+            _EMPLOYEE_FINDER,
+            body=body,
+            cast_to=PageNumberPage[Person],
+            timeout=timeout,
+        )
+
+    def waterfall_icp(
+        self,
+        *,
+        company_linkedin_url: str,
+        cascade: list[CascadeTier],
+        max_results: int | None = None,
+        timeout: TimeoutParam = None,
+    ) -> WaterfallIcpResponse:
+        """Find the best decision-maker at a company via a prioritized cascade."""
+        body = _drop_none(
+            company_linkedin_url=company_linkedin_url, cascade=cascade, max_results=max_results
+        )
+        return self._client._request(
+            "POST", _WATERFALL, body=body, cast_to=WaterfallIcpResponse, timeout=timeout
+        )

blitz_api/resources/_sync/utils.py

@@ -0,0 +1,45 @@
+# 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 CompanyEmploymentDistributionResponse, CurrentDateResponse
+
+if TYPE_CHECKING:
+    from ..._client import BlitzAPI
+
+_CURRENT_DATE = "/v2/utils/current-date"
+_EMPLOYMENT_DISTRIBUTION = "/v2/utils/company-employment-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,
+        )