# US Brand Signal Metrics Aggregator

> US Brand Signal Metrics Aggregator is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Aggregates and summarizes brand signal metrics for US brands, returning counts, severities, confidence scores, and event-type breakdowns across monitoring sources.

## Facts

- Endpoint: POST https://api.timzinin.com/api/us-brand-signal-metrics-aggregator
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-brand-signal-metrics-aggregator-15b9b047
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ysyx0koVoghuLBpysgsvP

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 us-brand-signal-metrics-aggregator-15b9b047 -d '<json body>'
```

Example prompt: Can you pull the aggregated brand signal metrics for our US brand — I want to see the severity breakdown, active vs resolved counts, and any high or critical signals flagged, especially around price changes and product launches?

## When to prefer this

Choose this endpoint when you need a structured, multi-dimensional summary of brand signals for a US brand across multiple monitoring sources in a single call — particularly when you need severity, confidence, and event-type breakdowns together. Prefer this over raw signal feeds when you want aggregated metrics rather than individual signal records, or when you need basis-point confidence scoring and digest-based deduplication.

## Known failure modes

- Invalid or missing brand identifier returns empty results or error
- Payment not settled results in 402 response blocking execution
- Malformed request body returns validation error
- Brand not found in US market returns zero-count result with no warnings
- Upstream monitoring sources unavailable may reduce signal coverage without explicit error

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON object with a meta block (run time, settled status, item count) and a results array containing: total/active/resolved signal counts, average basis points, confidence sum in basis points, input and result digests, counts broken down by source, status, severity, and event type, a high-or-critical count, and an array of warnings such as high_or_critical_present or low_confidence_present.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "signalId",
     "eventType",
     "severity",
     "sourceName",
     "confidenceBps",
     "status"
    ],
    "properties": {
     "status": {
      "enum": [
       "active",
       "resolved"
      ],
      "type": "string"
     },
     "severity": {
      "enum": [
       "low",
       "medium",
       "high",
       "critical"
      ],
      "type": "string"
     },
     "signalId": {
      "type": "string",
      "pattern": "^[ -~]{1,128}$",
      "maxLength": 128,
      "minLength": 1
     },
     "eventType": {
      "enum": [
       "product_launch",
       "price_change",
       "promotion",
       "inventory",
       "ad_campaign",
       "review",
       "risk",
       "regulatory",
       "hiring",
       "other"
      ],
      "type": "string"
     },
     "sourceName": {
      "type": "string",
      "pattern": "^[ -~]{1,128}$",
      "maxLength": 128,
      "minLength": 1
     },
     "confidenceBps": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100,
   "minItems": 1
  },
  "schemaVersion": {
   "enum": [
    "1.0"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "total": 3,
    "active": 2,
    "resolved": 1,
    "warnings": [
     "high_or_critical_present",
     "low_confidence_present",
     "resolved_signals_present"
    ],
    "averageBps": 7200,
    "inputDigest": "74fcd72d6bb0a4c8df7a6871b854b3fd14075a2181850b682566677c86cb1fd6",
    "resultDigest": "da0fb4528a8417b341f8dd89762e2c13657226a9cb11e6c8c561cd98c0129f73",
    "countsBySource": {
     "Brand newsroom": 1,
     "Retail monitor": 2
    },
    "countsByStatus": {
     "active": 2,
     "resolved": 1
    },
    "highOrCritical": 1,
    "confidenceSumBps": 21600,
    "countsBySeverity": {
     "low": 1,
     "high": 1,
     "medium": 1,
     "critical": 0
    },
    "countsByEventType": {
     "risk": 0,
     "other": 0,
     "hiring": 0,
     "review": 1,
     "inventory": 0,
     "promotion": 0,
     "regulatory": 0,
     "ad_campaign": 0,
     "price_change": 1,
     "product_launch": 1
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-brand-signal-metrics-aggregator-15b9b047/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)