pounce-agent-data

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

Installation

pip install pounce-agent-data

Quick Start

from pounce_agent_data import PounceClient

client = PounceClient(api_key="your_key")

# Search with advanced filters
results, rate = client.search(
    q="AI companies", country="CH", city="Zurich",
    founded_min=2020, sort="newest", limit=10
)
for company in results["items"]:
    print(company["canonical_name"], company["primary_domain"])

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

# Lookup by domain
company, rate = client.lookup("stripe.com")

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

# Analytics
countries, rate = client.analytics_countries()
sectors, rate = client.analytics_sectors(country="CH")

Generic Request

For any endpoint not covered by a convenience method — including new endpoints added after this SDK version — use request():

data, rate = client.request("GET", "/entities/export", params={"country": "CH", "format": "csv"})
data, rate = client.request("POST", "/webhooks", json={"url": "https://...", "events": ["entity.updated"]})

Authentication

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

export POUNCE_API_KEY=your_key

client = PounceClient()  # reads from env

API Methods

Search & Discovery

Entity Detail

Bulk & Export

Analytics

Webhooks

Other

Search Filters

results, rate = client.search(
    q="fintech",              # keyword search
    country="CH",             # ISO country code
    city="Zurich",            # city name
    founded_min=2020,         # minimum founding year
    founded_max=2025,         # maximum founding year
    first_seen_after="2025-01-01",  # only entities indexed after this date
    employee_range="11-50",   # 1-10, 11-50, 51-200, 201-500, 500+
    has_domain=True,          # only companies with a known domain
    sort="newest",            # relevance, newest, oldest, quality
    limit=25,
    offset=0,
)

Rate Limits

Every response includes rate limit info:

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

Plans

Links

• API Documentation
• Get an API Key