Metadata-Version: 2.4
Name: pounce-agent-data
Version: 2.0.0
Summary: Python SDK for the Pounce v2 Entity API — search, look up, and enrich 59M+ verified B2B companies.
Project-URL: Homepage, https://pounce.ch/developers
Project-URL: Documentation, https://pounce.ch/skill.md
Project-URL: Repository, https://gitlab.pounce.ch/pounce/pounce
Author-email: Pounce <hello@pounce.ch>
License-Expression: MIT
Keywords: agents,ai,api,b2b,companies,pounce,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Requires-Dist: httpx>=0.25.0
Description-Content-Type: text/markdown

# pounce-agent-data

Python SDK for the **Pounce v2 Entity API** — search, look up, and enrich 59M+ verified B2B companies.

## Installation

```bash
pip install pounce-agent-data
```

## Quick Start

```python
from pounce_agent_data import PounceClient

client = PounceClient(api_key="your_key")

# Search companies
results, rate = client.search(q="AI companies", country="CH", limit=10)
for company in results["items"]:
    print(company["canonical_name"], company["primary_domain"])

# Lookup by domain
company, rate = client.lookup("stripe.com")
print(company["canonical_name"], company["trust_tier"])

# AI semantic search (2 credits)
results, rate = client.semantic_search("fintech startups in Switzerland")

# Full company profile
detail, rate = client.detail(entity_id=12345)
```

## Authentication

Pass your API key directly or set the `POUNCE_API_KEY` environment variable:

```bash
export POUNCE_API_KEY=your_key
```

```python
client = PounceClient()  # reads from env
```

## API Methods

| Method | Credits | Description |
|--------|---------|-------------|
| `search()` | 1 | Filter companies by keyword, country, category |
| `semantic_search()` | 2 | AI-powered natural language search |
| `lookup(domain)` | 1 | Find a company by domain |
| `detail(entity_id)` | 1 | Full company profile |
| `bulk_lookup(domains)` | 1/found | Bulk lookup up to 100 domains |
| `match_score(a, b)` | 3 | Similarity score between two companies |
| `stats()` | 0 | Public platform statistics |

## Rate Limits

Every response includes rate limit info:

```python
results, rate = client.search(q="test")
print(rate.remaining)      # calls remaining this month
print(rate.credits_used)   # credits consumed by this call
```

## Plans

| Plan | Monthly Calls | Rate/Min |
|------|--------------|----------|
| Free | 100 | 30 |
| Developer ($39/mo) | 5,000 | 60 |
| Business ($149/mo) | 25,000 | 300 |
| Enterprise ($499/mo) | 200,000 | 1,000 |

## Links

- [API Documentation](https://pounce.ch/developers)
- [Get an API Key](https://pounce.ch/settings/api)
