best_gtm_api_plans
Find the best GTM APIs. We benchmark all the GTM APIs and we put the results on our website: datacircle.dev
This smolagents tool gives an API's plans best first by score, each with its rank, provider, plan, $ per 1,000 and its page on datacircle.dev. The tool calls GET /apis/{slug}/best on Datacircle's open API, https://api.datacircle.dev/v1. You need no key and no account.
Use it
from smolagents import load_tool
best_gtm_api_plans = load_tool("waynehamadi2/datacircle-best-gtm-api-plans", trust_remote_code=True)
print(best_gtm_api_plans(slug="email-finder", limit=3))
The tool answers with a dict. An agent's code reads the answer by key.
Inputs
| Input | Type | Meaning |
|---|---|---|
slug | string | The API's slug, like 'email-finder': list_gtm_apis(query)[0]['slug']. The API's dict from list_gtm_apis works too. |
limit | integer, optional | How many plans to give, 1 to 50. 5 when left out. |
The four Datacircle tools
Load the four tools at once from the collection Datacircle tools, then give them to an agent:
from smolagents import CodeAgent, InferenceClientModel, ToolCollection
tools = ToolCollection.from_hub("waynehamadi2/datacircle-tools-6af6bdc91ceddc280ce84b9c", trust_remote_code=True)
agent = CodeAgent(tools=[*tools.tools], model=InferenceClientModel())
agent.run("Which email finder API plan is best, and what do 1,000 emails cost?")
| Tool | Call | Answer |
|---|---|---|
list_gtm_apis | GET /apis | every GTM API on Datacircle, each with its slug, how many plans and providers it has, its best plan and its best page |
best_gtm_api_plans | GET /apis/{slug}/best | an API's plans best first by score, each with its rank, provider, plan, $ per 1,000 and its page on datacircle.dev |
search_gtm_api_plans | GET /plans | the plans of every API or of one, by provider or plan name, sorted by score, provider or price |
gtm_api_provider | GET /providers/{slug} | each API a provider sells, its rank on each, how many plans it has there and its best plan |
Each plan has a price, a score and a provider. Each plan also links to the plan's page on datacircle.dev, with every field. The tools use only Python's standard library. The API takes at most 60 calls a minute from one address.
Links
- Datacircle: https://datacircle.dev
- What each field means: https://datacircle.dev/fields
- The API's spec: https://api.datacircle.dev/v1/openapi.json