Metadata-Version: 2.4
Name: semantil
Version: 0.1.0
Summary: Official Python SDK for Semantil - Company Intelligence API
Project-URL: Homepage, https://semantil.com
Project-URL: Documentation, https://docs.semantil.com
Author: Semantil
License-Expression: MIT
Keywords: api,b2b,company-data,lead-generation,lookalike,sales
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.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Requires-Dist: requests>=2.20.0
Description-Content-Type: text/markdown

# 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)
