# citable.run AI Share of Voice

> citable.run AI Share of Voice is a paid API for AI agents from citable.run, paid per call via x402, $0.18/call, status unknown (last checked 2026-09-14).

Returns the share of AI citations across 2–10 competing domains, showing which domains are cited most by AI answer engines.

## Facts

- Endpoint: GET https://citable.run/v1/ai-share-of-voice
- Price: $0.18/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citable-run-ai-share-of-voice-16a7d4e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wR0gOHMnb5jP2GiU4YTj9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability citable-run-ai-share-of-voice-16a7d4e2
```

Example prompt: Compare the AI citation share of voice across these competing domains: hubspot.com, semrush.com, ahrefs.com, and moz.com — check both ChatGPT and Google AI.

## When to prefer this

Use this endpoint when you need to compare AI citation visibility across multiple competing domains simultaneously and want a normalized share-of-voice metric rather than raw citation counts. It is ideal for competitive intelligence dashboards, SEO audits, and marketing reports where relative AI presence matters more than absolute citation volume. Prefer this over the single-domain AI citation check when benchmarking 2–10 domains at once.

## Known failure modes

- Fewer than 2 or more than 10 domains submitted — validation error
- Invalid hostname format in domains list — parsing error
- Unsupported platform value (not chat_gpt or google) — enum validation failure
- Domain has no measurable AI citations — returns zero share for that domain
- Temporary AI platform API unavailability — upstream timeout or partial results

## How this service works

Share of AI citations across a set of 2–10 competing domains.

## Output

Returns a breakdown of AI citation share across the submitted domains, showing what percentage of AI-generated answers cite each domain. Results may be segmented by AI platform (ChatGPT and/or Google AI), allowing direct competitive comparison of AI visibility.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "domains"
     ],
     "properties": {
      "domains": {
       "type": "string",
       "description": "comma list of 2–10 hostnames"
      },
      "platform": {
       "type": "string",
       "description": "chat_gpt or google (default: both)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citable-run-ai-share-of-voice-16a7d4e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from citable.run](https://www.zero.xyz/host/citable.run/llms.txt)