# Semantil Python SDK

Official Python SDK for [Semantil](https://semantil.com) - Company Intelligence API.

Find similar companies, enrich company data, and build lookalike audiences.

## Installation

```bash
pip install semantil
```

## Quick Start

```python
from semantil import Semantil

client = Semantil("your-api-key")

# Find companies similar to Stripe
similar = client.find_similar("stripe.com", limit=10)
for company in similar["results"]:
    print(f"{company['domain']} - {company['score']}")

# Lookup company data
company = client.lookup("shopify.com")
print(company)

# Semantic search
results = client.search("fintech companies in Germany", limit=20)
```

## API Reference

### `Semantil(api_key, base_url=None)`

Initialize the client with your API key.

### `find_similar(domain, limit=10)`

Find companies similar to the given domain.

### `lookup(domain)`

Get company information by domain.

### `search(query, limit=10, filters=None)`

Semantic search for companies.

## Links

- [Documentation](https://docs.semantil.com)
- [API Reference](https://docs.semantil.com/api)
- [Get API Key](https://semantil.com)
