Metadata-Version: 2.5
Name: datacircle
Version: 0.1.0
Summary: Python client for the Datacircle API: find the best GTM APIs
Project-URL: Homepage, https://datacircle.dev
Project-URL: Documentation, https://api.datacircle.dev/v1/openapi.json
Project-URL: Repository, https://github.com/waynehamadi/datacircle-python
License-Expression: MIT
License-File: LICENSE
Keywords: api,api-directory,api-pricing,b2b-data,datacircle,gtm
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# datacircle

Find the best GTM APIs. We benchmark all the GTM APIs and we put the results on our website: https://datacircle.dev

A small Python client for the open Datacircle API (https://api.datacircle.dev/v1): no key, no account, no dependencies.

```
pip install datacircle
```

```python
import datacircle

datacircle.apis()                                  # every API on the sheet
datacircle.best("email-finder", limit=3)           # who is best for one API
datacircle.plans(api="email-finder", sort="price", limit=5)
datacircle.provider("hunter")                      # one provider's ranks
```

Each function is one call:

- `apis()`: `GET /apis`, every API on the sheet
- `best(slug, limit=None)`: `GET /apis/{slug}/best`, who is best for one API
- `plans(api=None, query=None, sort=None, limit=None, offset=None)`: `GET /plans`, every plan, by API, text or price (`sort`: `score`, `provider` or `price`)
- `provider(slug)`: `GET /providers/{slug}`, one provider's ranks on every API

Each returns the API's JSON as Python lists and dicts. The spec: https://api.datacircle.dev/v1/openapi.json. At most 60 calls a minute from one address; every plan is also one file at https://datacircle.dev/datacircle.json.
