Metadata-Version: 2.5
Name: langchain-datacircle
Version: 0.1.0
Summary: LangChain tools 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/langchain-datacircle
License-Expression: MIT
License-File: LICENSE
Keywords: api,api-pricing,b2b-data,datacircle,gtm,langchain,langchain-tools
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: langchain-core<2.0.0,>=0.3.15
Description-Content-Type: text/markdown

# langchain-datacircle

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

This package gives LangChain four tools on Datacircle's open API, https://api.datacircle.dev/v1. You need no key and no account.

```bash
pip install langchain-datacircle
```

| Tool | What it gives | Call |
| --- | --- | --- |
| `DatacircleListApisTool` (`datacircle_list_apis`) | Every GTM API on Datacircle, with its slug, number of plans and providers, and its best plan | `GET /apis` |
| `DatacircleBestPlansTool` (`datacircle_best_plans`) | One API's plans, best first by score out of 100, each with its rank and price per 1,000 calls | `GET /apis/{slug}/best` |
| `DatacircleSearchPlansTool` (`datacircle_search_plans`) | Plans by provider or plan name, on every API or one, sorted by score, provider or price | `GET /plans` |
| `DatacircleProviderTool` (`datacircle_provider`) | The APIs a provider sells and its rank on each | `GET /providers/{slug}` |

## Use

```python
from langchain_datacircle import DatacircleBestPlansTool, DatacircleToolkit

DatacircleBestPlansTool().invoke({"slug": "email-finder", "limit": 3})

tools = DatacircleToolkit().get_tools()  # the four, for an agent
```

With an agent (any chat model that calls tools):

```python
from langchain.agents import create_agent
from langchain_ollama import ChatOllama

agent = create_agent(ChatOllama(model="gpt-oss:20b"), tools=DatacircleToolkit().get_tools())
agent.invoke({"messages": [("user", "Which email finder API is best for under $5 per 1,000?")]})
```

Each tool gives a dict; an agent reads it as JSON. An unknown slug or a value out of range comes back as the tool's answer, with the API's words (an unknown API's answer lists every slug).

## Network

Each call makes one HTTPS GET to https://api.datacircle.dev/v1 with the tool's arguments and nothing else. The API takes up to 60 calls a minute from one address; the tools wait once, a minute at most, when it asks them to. Every plan is also one file at https://datacircle.dev/datacircle.json.

## Links

- Datacircle: https://datacircle.dev
- The API: https://datacircle.dev/api
- Its spec: https://api.datacircle.dev/v1/openapi.json
- What each key means: https://datacircle.dev/fields

MIT license.
