List tools

GET/v1/tools

No API key needed. Without one, requests are limited per IP address. A key sent must be valid.

List the tools in the catalog, ordered by platform and then by tool.

Each tool names the providers that can serve it and the lowest price of one call among them: what one call costs you. A tool with callable: false is listed but cannot be called yet. Filter by platform, category or callable.

No API key is needed. Without one, requests are rate limited per IP address.

Query parameters

platformstring

Only tools on this platform, by its slug.

categorystring

Only tools of this category.

seo

social

enrichment

reviews

callableboolean

Only tools that can be called today (true) or that cannot yet (false).

Response

Every tool that matches the filters. A tool as the catalog lists it. providers are the providers that can serve it. from_price_usd is what one call costs you at the cheapest of them, null when there are none. A provider priced by results counts at its max_price_usd.

The body is a JSON array. Each item has these fields.

toolstring

The tool's ID, as calls and quotes take it.

namestring

The tool's name.

platformobject

The platform the tool's data is about.

platform.slugstring

The platform's ID, as the platform filter takes it.

platform.namestring

The platform's name.

categorystring

The kind of data it returns.

seo

social

enrichment

reviews

callableboolean

Whether the tool can be called today.

from_price_usdstring· nullable

What one call costs at the cheapest provider. Null when no provider can serve it.

providersarray of string

The IDs of the providers that can serve it.

400Refused request body

The request was refused.

401INVALID_AUTH_TOKENRefused request body

An API key was sent and is wrong or revoked.

422VALIDATIONInvalid request body

The request is not valid.

429RATE_LIMITEDRefused request body

Too many requests without an API key from this IP address, or with this API key.

Retry-After: Seconds until the limit resets.

curl "https://api.voxoria.ai/v1/tools?callable=true"

import httpx

response = httpx.get(
    "https://api.voxoria.ai/v1/tools",
    params={"callable": True},
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools?callable=true");
console.log(await response.json());

{
  "name": "list_tools",
  "arguments": {
    "callable": true
  }
}

200 OKResponseapplication/json

[
  {
    "tool": "google.serp.organic",
    "name": "Search Google organic results",
    "platform": {
      "slug": "google",
      "name": "Google"
    },
    "category": "seo",
    "callable": true,
    "from_price_usd": "0.0214",
    "providers": [
      "example-provider",
      "another-provider"
    ]
  }
]