discolike 0.1.0

Official Python SDK for the DiscoLike API

discolike

Official Python SDK for the DiscoLike API — discover lookalike companies, enrich domain lists, match company names to domains, and find contacts, from typed Python.

For the terminal, see discolike-cli (pip install discolike-cli or uvx --from discolike-cli discolike).

Installation

pip install discolike

Requires Python 3.10+.

Authentication

export DISCOLIKE_API_KEY="dl_..."

Create a key at app.discolike.com/account/management/keys. You can also pass api_key=... explicitly to Discolike().

Quickstart

from discolike import Discolike

client = Discolike()

companies = client.discover(
    icp_text="Cybersecurity for SMBs, managed IT services, endpoint protection",
    country=["US"],
    max_records=25,
)
for company in companies:
    print(company.domain, company.name, company.similarity)

The client is a context manager if you want deterministic cleanup:

with Discolike() as client:
    ...

Async

Every resource has an async twin on AsyncDiscolike:

import asyncio
from discolike import AsyncDiscolike

async def main() -> None:
    async with AsyncDiscolike() as client:
        companies = await client.discover(icp_text="B2B SaaS for logistics", max_records=10)
        print([c.domain for c in companies])

asyncio.run(main())

Long-running jobs

Bulk operations (match.bulk, segment, validate_icp, contacts.bulk_match) return a Job handle instead of blocking:

job = client.segment(domains=["stripe.com", "adyen.com", "checkout.com"])
result = job.wait()

Job.status() polls without blocking, Job.cancel() aborts, and wait() raises JobFailedError / JobTimeoutError on failure.

Links

• API documentation: docs.discolike.com
• Source: github.com/Discolike/discolike-python

License

MIT