Integration API

Overview

The Integration API exposes the same read-only dashboard metrics available in Symios, scoped to a company via API credentials managed in the Symios dashboard.

Base URL

https://api.symios.ai/v2/integration

What you can do

List brands and query sets for the authenticated company
List published runs for a query set
Fetch Overview, Presence, Life, Gravity, Scout, and Market card payloads
Connect LLM apps and IDEs via the hosted MCP server

What you cannot do

Mutate data (create, update, or delete)
Authenticate as a dashboard user (Bearer authToken is a separate surface)
Access brands outside the credential’s company

Example

Typical catalog call

Endpoint

GET /sets/brands/{brandId}/list

Query string parameters

None

Return

[
    {
        "id": 42,
        "name": "Italy Q4",
        "created_at": "2026-03-01T10:00:00+00:00"
    }
]

Example

curl -sS "https://api.symios.ai/v2/integration/sets/brands/12/list" \
  -H "X-Api-Key: sk_live_YOUR_KEY" \
  -H "X-Api-Secret: YOUR_SECRET"

const response = await fetch('https://api.symios.ai/v2/integration/sets/brands/12/list', {
  headers: {
    'X-Api-Key': 'sk_live_YOUR_KEY',
    'X-Api-Secret': 'YOUR_SECRET',
  },
});
const data = await response.json();
console.log(data);

$ch = curl_init('https://api.symios.ai/v2/integration/sets/brands/12/list');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'X-Api-Key: sk_live_YOUR_KEY',
    'X-Api-Secret: YOUR_SECRET',
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);