Back to APIs

Unified Agent API

Agent API

Agent API

A single API that autonomously routes to any capability. Describe what you need, and it selects the right API, fills the parameters, and executes it.

POST/v1/agent

Overview

Single endpoint routing to any capability

Credits

2 credits per call

Parameters

capabilityRequired

select (default: search)

Which capability to use.

paramsRequired

object (default: {"query": "latest AI news"})

The capability's parameters, as a JSON object.

Example Response

{
  "success": true,
  "data": {
    "answer": "AI funding reached $4.2B in Q1 2026, led by xAI and Anthropic.",
    "organic_results": [
      {
        "url": "https://techcrunch.com/2026/04/01/ai-funding",
        "title": "AI Funding Hits Record",
        "snippet": "Venture capital investment...",
        "position": 1
      }
    ]
  },
  "metadata": {
    "provider_used": "perplexity",
    "providers_tried": [
      "perplexity"
    ],
    "mode_used": "ai",
    "response_time_ms": 2400,
    "request_id": "req_ijk123"
  },
  "credits_used": 2
}

Get Started

Create a Suprsonic API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try Agent API

Test Agent API in the interactive playground. No setup required.

Open Playground