Skip to main content

semantic-kernel-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 is a Semantic Kernel plugin on Datacircle's open API, https://api.datacircle.dev/v1. You need no key and no account.

pip install semantic-kernel-datacircle
Function What it gives Call
list_apis Every GTM API on Datacircle, with its slug, number of plans and providers, and its best plan GET /apis
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
search_plans Plans by provider or plan name, on every API or one, sorted by score, provider or price GET /plans
provider The APIs a provider sells and its rank on each GET /providers/{slug}

Use

With an agent:

import asyncio

from semantic_kernel.agents import ChatCompletionAgent
from semantic_kernel.connectors.ai.open_ai import OpenAIChatCompletion
from semantic_kernel_datacircle import DatacirclePlugin

agent = ChatCompletionAgent(
    service=OpenAIChatCompletion(),
    name="GTMAssistant",
    instructions="Answer from the Datacircle functions.",
    plugins=[DatacirclePlugin()],
)


async def main():
    response = await agent.get_response(messages="Which email finder API is best for under $5 per 1,000?")
    print(response)


asyncio.run(main())

Or on a kernel, with auto function calling:

from semantic_kernel import Kernel
from semantic_kernel.connectors.ai import FunctionChoiceBehavior
from semantic_kernel.connectors.ai.open_ai import OpenAIChatCompletion, OpenAIChatPromptExecutionSettings
from semantic_kernel.functions import KernelArguments
from semantic_kernel_datacircle import DatacirclePlugin

kernel = Kernel()
kernel.add_service(OpenAIChatCompletion())
kernel.add_plugin(DatacirclePlugin(), plugin_name="datacircle")

settings = OpenAIChatPromptExecutionSettings(function_choice_behavior=FunctionChoiceBehavior.Auto())
result = await kernel.invoke_prompt("Who sells the cheapest Hunter plan?", arguments=KernelArguments(settings=settings))

Any chat completion service with function calling works. Each function is a @kernel_function that gives the model the API's answer as JSON. A function can also be called through the kernel itself:

await kernel.invoke(plugin_name="datacircle", function_name="best_plans", arguments=KernelArguments(slug="email-finder", limit=3))

or as a plain function that gives a dict:

from semantic_kernel_datacircle import best_plans

best_plans(slug="email-finder", limit=3)

Each plan comes with its rank, provider, plan, score, price per 1,000 (perThousand, in dollars) and its page on datacircle.dev, which lists every field. An unknown slug or a value out of range comes back as {"error": ...} with the API's words (an unknown API's answer lists every slug), so the model can call again.

Network

Each call makes one HTTPS GET to https://api.datacircle.dev/v1 with the function's arguments and nothing else. The API takes up to 60 calls a minute from one address; the functions wait once, a minute at most, when it asks them to. DatacirclePlugin(timeout=10) sets how long a call may take. Every plan is also one file at https://datacircle.dev/datacircle.json.

MIT license.

Metadata

Release files for semantic-kernel-datacircle 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for semantic-kernel-datacircle 0.1.0
File Size Uploaded Provenance Actions
semantic_kernel_datacircle-0.1.0.tar.gz 9.4 kB Without provenance Details for semantic_kernel_datacircle-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for semantic-kernel-datacircle 0.1.0
File Interpreter ABI Platform Actions
semantic_kernel_datacircle-0.1.0-py3-none-any.whl Python 3 none any Details for semantic_kernel_datacircle-0.1.0-py3-none-any.whl

Total release size: 18.7 kB

Release files / semantic_kernel_datacircle-0.1.0.tar.gz

Download URL semantic_kernel_datacircle-0.1.0.tar.gz
Size 9.4 kB
Tags Source
SHA-256 checksum
How to use checksums
783aedf7ad23d01a5d78c59b682badf19330ad2b2b64511f5e95c1dd3b5c88a0
BLAKE2b-256 checksum
How to use checksums
7dee23a97f56a5194a15261ba4c436d7ae6a35f95245d07c36ab9620f702a15b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / semantic_kernel_datacircle-0.1.0-py3-none-any.whl

Download URL semantic_kernel_datacircle-0.1.0-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c534b5bb5ad3bed433a1e0e2f81db3d5503058f8324f7cd5f2738d02e2f30c54
BLAKE2b-256 checksum
How to use checksums
9ed25967e46b59f41574365866005c5aa92ae8f3270155690e639c11914efcbe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for semantic-kernel-datacircle 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page