tech-stack-lookup 0.1.0__tar.gz

tech_stack_lookup-0.1.0/LICENSE

@@ -0,0 +1,5 @@
+MIT License
+
+Copyright (c) 2026 ApiVault Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

tech_stack_lookup-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: tech-stack-lookup
+Version: 0.1.0
+Summary: Python SDK for Tech Stack Lookup on Apify. Find websites by technologies, market signals and public contact availability through the hosted Apify Actor.
+Author: ApiVault Labs
+License: MIT
+Project-URL: Homepage, https://github.com/apivault-labs/tech-stack-lookup-python
+Project-URL: Documentation, https://github.com/apivault-labs/tech-stack-lookup-python#readme
+Project-URL: Apify Actor, https://apify.com/apivault_labs/tech-stack-lookup
+Project-URL: Bug Tracker, https://github.com/apivault-labs/tech-stack-lookup-python/issues
+Keywords: tech-stack,technology-lookup,website-leads,sales-intelligence,b2b-leads,apify,python-sdk
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# Tech Stack Lookup — Python SDK
+
+Python client for the [Tech Stack Lookup Apify Actor](https://apify.com/apivault_labs/tech-stack-lookup). Send public Actor inputs, wait for the hosted run, and receive clean Dataset rows without maintaining scraping infrastructure.
+
+[![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue)](https://apify.com/apivault_labs/tech-stack-lookup)
+[![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## Results
+
+- Technology and category targeting
+- Country and vertical filters
+- Public contact availability filters
+- Stable sorting, pagination and count previews
+
+The repository exposes only the Actor's public input and output contract. Data selection and processing remain inside the hosted Actor.
+
+## Install
+
+```bash
+pip install git+https://github.com/apivault-labs/tech-stack-lookup-python.git
+```
+
+Create an Apify token at [Console → Integrations](https://console.apify.com/account/integrations), then:
+
+```python
+from tech_stack_lookup import TechStackLookupClient
+
+client = TechStackLookupClient(api_token="apify_api_xxxxxx")
+rows = client.run({'mode': 'find',
+ 'technologies': ['Shopify'],
+ 'country': ['US'],
+ 'hasEmail': True,
+ 'maxItems': 100})
+print(rows[0] if rows else "No results")
+```
+
+You can set `APIFY_API_TOKEN` instead of passing the token in code.
+
+## Public input options
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `mode` | `string` | `find` | Find matching websites or inspect supplied domains. |
+| `domains` | `array` | `[]` | Domains to inspect in lookup mode. |
+| `technologies` | `array` | `[]` | Technology names to include. |
+| `matchMode` | `string` | `any` | Match any or all selected technologies. |
+| `excludeTechnologies` | `array` | `[]` | Technology names to exclude. |
+| `category` | `array` | `[]` | Technology categories to include. |
+| `country` | `array` | `[]` | ISO-2 country codes. |
+| `vertical` | `array` | `[]` | Business verticals to include. |
+| `hasEmail` | `boolean` | `False` | Return records with a public email. |
+| `hasPhone` | `boolean` | `False` | Return records with a public phone. |
+| `sortBy` | `string` | `` | Public field used to order results. |
+| `sortDesc` | `boolean` | `True` | Return highest values first. |
+| `dedupeByDomain` | `boolean` | `True` | Return each root domain once. |
+| `outputPreset` | `string` | `essential` | Choose a public result layout. |
+| `countOnly` | `boolean` | `False` | Return a count preview instead of rows. |
+| `maxItems` | `integer` | `100` | Maximum number of returned rows. |
+| `offset` | `integer` | `0` | Rows to skip for pagination. |
+
+The complete, versioned schema is also available on the [Actor page](https://apify.com/apivault_labs/tech-stack-lookup).
+
+## Pricing
+
+Pay per delivered result through Apify, starting around **$7/1,000 results** on paid tiers. Free-plan pricing and platform usage can differ; check the Actor page before large runs.
+
+## Examples
+
+- `examples/quickstart.py` — first run
+- `examples/bulk_analysis.py` — expand a target list
+- `examples/export_csv.py` — save flat result fields
+- `examples/save_json.py` — preserve nested output
+- `examples/cost_estimate.py` — estimate result-event charges
+- `examples/environment_token.py` — keep credentials out of code
+
+## Architecture and privacy
+
+This repository is intentionally a thin API client. Collection, retries, analysis and billing run inside the hosted Apify Actor. No private implementation, credentials, scoring weights or infrastructure configuration are included.
+
+## License
+
+MIT. The hosted Actor is a separate paid service governed by Apify terms.

tech_stack_lookup-0.1.0/README.md

@@ -0,0 +1,83 @@
+# Tech Stack Lookup — Python SDK
+
+Python client for the [Tech Stack Lookup Apify Actor](https://apify.com/apivault_labs/tech-stack-lookup). Send public Actor inputs, wait for the hosted run, and receive clean Dataset rows without maintaining scraping infrastructure.
+
+[![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue)](https://apify.com/apivault_labs/tech-stack-lookup)
+[![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## Results
+
+- Technology and category targeting
+- Country and vertical filters
+- Public contact availability filters
+- Stable sorting, pagination and count previews
+
+The repository exposes only the Actor's public input and output contract. Data selection and processing remain inside the hosted Actor.
+
+## Install
+
+```bash
+pip install git+https://github.com/apivault-labs/tech-stack-lookup-python.git
+```
+
+Create an Apify token at [Console → Integrations](https://console.apify.com/account/integrations), then:
+
+```python
+from tech_stack_lookup import TechStackLookupClient
+
+client = TechStackLookupClient(api_token="apify_api_xxxxxx")
+rows = client.run({'mode': 'find',
+ 'technologies': ['Shopify'],
+ 'country': ['US'],
+ 'hasEmail': True,
+ 'maxItems': 100})
+print(rows[0] if rows else "No results")
+```
+
+You can set `APIFY_API_TOKEN` instead of passing the token in code.
+
+## Public input options
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `mode` | `string` | `find` | Find matching websites or inspect supplied domains. |
+| `domains` | `array` | `[]` | Domains to inspect in lookup mode. |
+| `technologies` | `array` | `[]` | Technology names to include. |
+| `matchMode` | `string` | `any` | Match any or all selected technologies. |
+| `excludeTechnologies` | `array` | `[]` | Technology names to exclude. |
+| `category` | `array` | `[]` | Technology categories to include. |
+| `country` | `array` | `[]` | ISO-2 country codes. |
+| `vertical` | `array` | `[]` | Business verticals to include. |
+| `hasEmail` | `boolean` | `False` | Return records with a public email. |
+| `hasPhone` | `boolean` | `False` | Return records with a public phone. |
+| `sortBy` | `string` | `` | Public field used to order results. |
+| `sortDesc` | `boolean` | `True` | Return highest values first. |
+| `dedupeByDomain` | `boolean` | `True` | Return each root domain once. |
+| `outputPreset` | `string` | `essential` | Choose a public result layout. |
+| `countOnly` | `boolean` | `False` | Return a count preview instead of rows. |
+| `maxItems` | `integer` | `100` | Maximum number of returned rows. |
+| `offset` | `integer` | `0` | Rows to skip for pagination. |
+
+The complete, versioned schema is also available on the [Actor page](https://apify.com/apivault_labs/tech-stack-lookup).
+
+## Pricing
+
+Pay per delivered result through Apify, starting around **$7/1,000 results** on paid tiers. Free-plan pricing and platform usage can differ; check the Actor page before large runs.
+
+## Examples
+
+- `examples/quickstart.py` — first run
+- `examples/bulk_analysis.py` — expand a target list
+- `examples/export_csv.py` — save flat result fields
+- `examples/save_json.py` — preserve nested output
+- `examples/cost_estimate.py` — estimate result-event charges
+- `examples/environment_token.py` — keep credentials out of code
+
+## Architecture and privacy
+
+This repository is intentionally a thin API client. Collection, retries, analysis and billing run inside the hosted Apify Actor. No private implementation, credentials, scoring weights or infrastructure configuration are included.
+
+## License
+
+MIT. The hosted Actor is a separate paid service governed by Apify terms.

tech_stack_lookup-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tech-stack-lookup"
+version = "0.1.0"
+description = "Python SDK for Tech Stack Lookup on Apify. Find websites by technologies, market signals and public contact availability through the hosted Apify Actor."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "ApiVault Labs" }]
+requires-python = ">=3.9"
+dependencies = ["requests>=2.31.0"]
+keywords = ["tech-stack", "technology-lookup", "website-leads", "sales-intelligence", "b2b-leads", "apify", "python-sdk"]
+
+[project.urls]
+Homepage = "https://github.com/apivault-labs/tech-stack-lookup-python"
+Documentation = "https://github.com/apivault-labs/tech-stack-lookup-python#readme"
+"Apify Actor" = "https://apify.com/apivault_labs/tech-stack-lookup"
+"Bug Tracker" = "https://github.com/apivault-labs/tech-stack-lookup-python/issues"
+
+[tool.setuptools.packages.find]
+include = ["tech_stack_lookup*"]

tech_stack_lookup-0.1.0/setup.cfg

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

tech_stack_lookup-0.1.0/tech_stack_lookup/__init__.py

@@ -0,0 +1,6 @@
+"""Python SDK for the hosted Tech Stack Lookup Apify Actor."""
+from .client import TechStackLookupClient
+from .exceptions import TechStackLookupError, AuthenticationError, ActorRunError, ActorTimeoutError
+
+__version__ = "0.1.0"
+__all__ = ["TechStackLookupClient", "TechStackLookupError", "AuthenticationError", "ActorRunError", "ActorTimeoutError"]

tech_stack_lookup-0.1.0/tech_stack_lookup/client.py

@@ -0,0 +1,112 @@
+"""Thin synchronous client for the Tech Stack Lookup Apify Actor."""
+from __future__ import annotations
+
+import os
+import time
+from typing import Any, Mapping
+
+import requests
+
+from .exceptions import ActorRunError, ActorTimeoutError, AuthenticationError, TechStackLookupError
+
+ACTOR_ID = "apivault_labs~tech-stack-lookup"
+APIFY_API_BASE = "https://api.apify.com/v2"
+TERMINAL_FAIL = {"FAILED", "TIMED-OUT", "ABORTED"}
+
+
+class TechStackLookupClient:
+    """Run the hosted Actor and download its Dataset results."""
+
+    def __init__(self, api_token: str | None = None, timeout: int = 600,
+                 poll_interval: float = 3.0):
+        token = api_token or os.environ.get("APIFY_API_TOKEN")
+        if not token:
+            raise AuthenticationError(
+                "Pass api_token or set APIFY_API_TOKEN. Create a token at "
+                "https://console.apify.com/account/integrations"
+            )
+        self.timeout = int(timeout)
+        self.poll_interval = float(poll_interval)
+        self.base_url = APIFY_API_BASE
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {token}",
+            "Content-Type": "application/json",
+            "User-Agent": "tech-stack-lookup-python/0.1.0",
+        })
+
+    def run(self, actor_input: Mapping[str, Any], *, actor_timeout_secs: int = 300) -> list[dict[str, Any]]:
+        """Start one Actor run, wait for completion and return clean Dataset items."""
+        if not isinstance(actor_input, Mapping):
+            raise TypeError("actor_input must be a mapping")
+        run_id = self._start(dict(actor_input), actor_timeout_secs)
+        run = self._wait(run_id)
+        dataset_id = run.get("defaultDatasetId")
+        if not dataset_id:
+            raise ActorRunError("Successful run did not expose a Dataset ID")
+        return self._dataset(dataset_id)
+
+    def run_one(self, actor_input: Mapping[str, Any], **kwargs: Any) -> dict[str, Any]:
+        """Return the first Dataset row, raising when no result was produced."""
+        rows = self.run(actor_input, **kwargs)
+        if not rows:
+            raise ActorRunError("Actor completed but returned no Dataset rows")
+        return rows[0]
+
+    @staticmethod
+    def estimate_cost(result_count: int, price_per_1000: float = 7.0) -> float:
+        """Estimate result charges; actual tier pricing and platform usage may vary."""
+        if result_count < 0:
+            raise ValueError("result_count cannot be negative")
+        return round(result_count * price_per_1000 / 1000, 6)
+
+    def _start(self, payload: dict[str, Any], timeout_secs: int) -> str:
+        try:
+            response = self.session.post(
+                f"{self.base_url}/acts/{ACTOR_ID}/runs",
+                params={"timeout": int(timeout_secs)}, json=payload, timeout=30,
+            )
+        except requests.RequestException as exc:
+            raise TechStackLookupError(f"Could not start Actor run: {exc}") from exc
+        if response.status_code == 401:
+            raise AuthenticationError("Apify rejected the API token")
+        if response.status_code >= 400:
+            raise ActorRunError(f"Run start failed with HTTP {response.status_code}: {response.text[:300]}")
+        run_id = (response.json().get("data") or {}).get("id")
+        if not run_id:
+            raise ActorRunError("Apify response did not contain a run ID")
+        return run_id
+
+    def _wait(self, run_id: str) -> dict[str, Any]:
+        deadline = time.monotonic() + self.timeout
+        while True:
+            try:
+                response = self.session.get(f"{self.base_url}/actor-runs/{run_id}", timeout=30)
+            except requests.RequestException as exc:
+                raise TechStackLookupError(f"Could not poll Actor run: {exc}") from exc
+            if response.status_code >= 400:
+                raise ActorRunError(f"Run poll failed with HTTP {response.status_code}: {response.text[:300]}")
+            run = response.json().get("data") or {}
+            status = run.get("status")
+            if status == "SUCCEEDED":
+                return run
+            if status in TERMINAL_FAIL:
+                raise ActorRunError(f"Actor run ended with {status}: {run.get('statusMessage') or 'no details'}")
+            if time.monotonic() >= deadline:
+                raise ActorTimeoutError(f"Actor run {run_id} did not finish within {self.timeout} seconds")
+            time.sleep(self.poll_interval)
+
+    def _dataset(self, dataset_id: str) -> list[dict[str, Any]]:
+        try:
+            response = self.session.get(
+                f"{self.base_url}/datasets/{dataset_id}/items",
+                params={"clean": "true", "format": "json"}, timeout=120,
+            )
+        except requests.RequestException as exc:
+            raise TechStackLookupError(f"Could not download Dataset: {exc}") from exc
+        if response.status_code >= 400:
+            raise ActorRunError(f"Dataset fetch failed with HTTP {response.status_code}: {response.text[:300]}")
+        data = response.json()
+        if not isinstance(data, list):
+            raise ActorRunError("Unexpected Dataset response type")
+        return data

tech_stack_lookup-0.1.0/tech_stack_lookup/exceptions.py

@@ -0,0 +1,13 @@
+"""Public exception hierarchy for the Tech Stack Lookup SDK."""
+
+class TechStackLookupError(Exception):
+    """Base SDK error."""
+
+class AuthenticationError(TechStackLookupError):
+    """The Apify token is missing or rejected."""
+
+class ActorRunError(TechStackLookupError):
+    """The Actor run or Dataset request failed."""
+
+class ActorTimeoutError(TechStackLookupError):
+    """The client stopped waiting before the Actor completed."""

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

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: tech-stack-lookup
+Version: 0.1.0
+Summary: Python SDK for Tech Stack Lookup on Apify. Find websites by technologies, market signals and public contact availability through the hosted Apify Actor.
+Author: ApiVault Labs
+License: MIT
+Project-URL: Homepage, https://github.com/apivault-labs/tech-stack-lookup-python
+Project-URL: Documentation, https://github.com/apivault-labs/tech-stack-lookup-python#readme
+Project-URL: Apify Actor, https://apify.com/apivault_labs/tech-stack-lookup
+Project-URL: Bug Tracker, https://github.com/apivault-labs/tech-stack-lookup-python/issues
+Keywords: tech-stack,technology-lookup,website-leads,sales-intelligence,b2b-leads,apify,python-sdk
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# Tech Stack Lookup — Python SDK
+
+Python client for the [Tech Stack Lookup Apify Actor](https://apify.com/apivault_labs/tech-stack-lookup). Send public Actor inputs, wait for the hosted run, and receive clean Dataset rows without maintaining scraping infrastructure.
+
+[![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue)](https://apify.com/apivault_labs/tech-stack-lookup)
+[![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## Results
+
+- Technology and category targeting
+- Country and vertical filters
+- Public contact availability filters
+- Stable sorting, pagination and count previews
+
+The repository exposes only the Actor's public input and output contract. Data selection and processing remain inside the hosted Actor.
+
+## Install
+
+```bash
+pip install git+https://github.com/apivault-labs/tech-stack-lookup-python.git
+```
+
+Create an Apify token at [Console → Integrations](https://console.apify.com/account/integrations), then:
+
+```python
+from tech_stack_lookup import TechStackLookupClient
+
+client = TechStackLookupClient(api_token="apify_api_xxxxxx")
+rows = client.run({'mode': 'find',
+ 'technologies': ['Shopify'],
+ 'country': ['US'],
+ 'hasEmail': True,
+ 'maxItems': 100})
+print(rows[0] if rows else "No results")
+```
+
+You can set `APIFY_API_TOKEN` instead of passing the token in code.
+
+## Public input options
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `mode` | `string` | `find` | Find matching websites or inspect supplied domains. |
+| `domains` | `array` | `[]` | Domains to inspect in lookup mode. |
+| `technologies` | `array` | `[]` | Technology names to include. |
+| `matchMode` | `string` | `any` | Match any or all selected technologies. |
+| `excludeTechnologies` | `array` | `[]` | Technology names to exclude. |
+| `category` | `array` | `[]` | Technology categories to include. |
+| `country` | `array` | `[]` | ISO-2 country codes. |
+| `vertical` | `array` | `[]` | Business verticals to include. |
+| `hasEmail` | `boolean` | `False` | Return records with a public email. |
+| `hasPhone` | `boolean` | `False` | Return records with a public phone. |
+| `sortBy` | `string` | `` | Public field used to order results. |
+| `sortDesc` | `boolean` | `True` | Return highest values first. |
+| `dedupeByDomain` | `boolean` | `True` | Return each root domain once. |
+| `outputPreset` | `string` | `essential` | Choose a public result layout. |
+| `countOnly` | `boolean` | `False` | Return a count preview instead of rows. |
+| `maxItems` | `integer` | `100` | Maximum number of returned rows. |
+| `offset` | `integer` | `0` | Rows to skip for pagination. |
+
+The complete, versioned schema is also available on the [Actor page](https://apify.com/apivault_labs/tech-stack-lookup).
+
+## Pricing
+
+Pay per delivered result through Apify, starting around **$7/1,000 results** on paid tiers. Free-plan pricing and platform usage can differ; check the Actor page before large runs.
+
+## Examples
+
+- `examples/quickstart.py` — first run
+- `examples/bulk_analysis.py` — expand a target list
+- `examples/export_csv.py` — save flat result fields
+- `examples/save_json.py` — preserve nested output
+- `examples/cost_estimate.py` — estimate result-event charges
+- `examples/environment_token.py` — keep credentials out of code
+
+## Architecture and privacy
+
+This repository is intentionally a thin API client. Collection, retries, analysis and billing run inside the hosted Apify Actor. No private implementation, credentials, scoring weights or infrastructure configuration are included.
+
+## License
+
+MIT. The hosted Actor is a separate paid service governed by Apify terms.

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

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+tech_stack_lookup/__init__.py
+tech_stack_lookup/client.py
+tech_stack_lookup/exceptions.py
+tech_stack_lookup.egg-info/PKG-INFO
+tech_stack_lookup.egg-info/SOURCES.txt
+tech_stack_lookup.egg-info/dependency_links.txt
+tech_stack_lookup.egg-info/requires.txt
+tech_stack_lookup.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+requests>=2.31.0

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

@@ -0,0 +1 @@
+tech_stack_lookup