list_gtm_apis
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 every GTM API on Datacircle, each with its slug, how many plans and providers it has, its best plan and its best page. The tool calls GET /apis on Datacircle's open API, https://api.datacircle.dev/v1. You need no key and no account.
Use it
from smolagents import load_tool
list_gtm_apis = load_tool("waynehamadi2/datacircle-list-gtm-apis", trust_remote_code=True)
print(list_gtm_apis(query="email", limit=3))
The tool answers with a list. An agent's code reads the answer by key.
Inputs
| Input | Type | Meaning |
|---|---|---|
query | string, optional | Words of the API's name or slug, like 'email' or 'linkedin profile': the APIs that hold the most of them come first. The sheet's order when left out. |
limit | integer, optional | How many APIs to give, 1 to 200. 20 when left out: the sheet has about 150. |
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