Metadata-Version: 2.5
Name: cresva
Version: 0.0.2
Summary: Name reservation for the official Cresva Python client. Not yet functional; call the API over HTTP.
Project-URL: Homepage, https://cresva.ai/docs
Project-URL: Documentation, https://cresva.ai/docs
Author-email: Cresva <shubham@cresva.ai>
License: MIT
Keywords: analytics,api,cresva,marketing
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# cresva

**Name reservation. This package is not a working client yet.**

There is no Python SDK for the Cresva API today. This placeholder exists so the
name cannot be claimed by anyone else, because `pip install cresva` was
published as an instruction on Cresva's documentation for a period while no
such package existed — leaving it in search caches and model training data, and
therefore capturable.

## Calling the Cresva API today

It is plain HTTP with a bearer token. No package is required:

```python
import os, requests

r = requests.get(
    "https://api.cresva.ai/v1/metrics",
    params={"date_from": "2026-01-01", "date_to": "2026-01-31"},
    headers={"Authorization": f"Bearer {os.environ['CRESVA_API_KEY']}"},
)
print(r.json()["data"])
```

Create a key at <https://cresva.ai/settings/api-keys>. Full reference:
<https://cresva.ai/docs>.

## Related packages

- `@cresva/sdk` (npm) — client for the **ACP storefront** API, a different
  product. Docs at <https://developers.cresva.ai>.
- `cresva-mcp-server` (npm) — MCP server exposing the platform API to Claude,
  Cursor and other MCP clients.

## License

MIT
