# US Brand Signal Brand Summary

> US Brand Signal Brand Summary 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 intelligence signals (reviews, risks, price changes, product launches, etc.) across one or more US brands into a structured per-brand digest

## Facts

- Endpoint: POST https://api.timzinin.com/api/us-brand-signal-brand-summary
- 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-brand-summary-b28320cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GN_TRlVnO_RmS6tbwHYNc

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-brand-summary-b28320cf -d '<json body>'
```

Example prompt: Can you pull a brand signal summary for Apple and Nike — I want to see how many signals each has, what event types are covered like reviews or price changes, and whether there are any critical or high-severity signals active right now?

## When to prefer this

Choose this endpoint when you need a structured, aggregated summary of brand signals across one or more US brands — especially when you want severity, status, and event-type breakdowns in a single call rather than raw signal feeds. It is particularly useful for competitive intelligence workflows, brand risk dashboards, or agent pipelines that need a compact per-brand digest with cryptographic integrity (digest hashes) for auditability.

## Known failure modes

- Invalid or unrecognized brand names may return empty results
- Unverified attribution means signal data accuracy is not guaranteed
- Payment failure via x402 protocol results in no response
- Malformed POST body may return a 400 error
- No signals found for a brand returns an empty brandSummaries array
- Schema version mismatch may cause downstream parsing issues

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON object containing per-brand summaries with total signal counts, breakdowns by status (active/resolved), severity (low/medium/high/critical), and event type (review, risk, price_change, product_launch, etc.), along with source URLs and hosts, signal IDs, attribution metadata, a summaryDigest hash, and run metadata including execution time and item count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "signalId",
     "brandName",
     "eventType",
     "severity",
     "status",
     "observedAt",
     "sourceUrl"
    ],
    "properties": {
     "status": {
      "enum": [
       "active",
       "resolved"
      ],
      "type": "string"
     },
     "severity": {
      "enum": [
       "low",
       "medium",
       "high",
       "critical"
      ],
      "type": "string"
     },
     "signalId": {
      "type": "string",
      "pattern": "^[\\x20-\\x7E]{1,64}$",
      "maxLength": 64,
      "minLength": 1
     },
     "brandName": {
      "type": "string",
      "pattern": "^[\\x20-\\x7E]{1,48}$",
      "maxLength": 48,
      "minLength": 1
     },
     "eventType": {
      "enum": [
       "product_launch",
       "price_change",
       "promotion",
       "inventory",
       "ad_campaign",
       "review",
       "risk",
       "regulatory",
       "hiring",
       "other"
      ],
      "type": "string"
     },
     "sourceUrl": {
      "type": "string",
      "pattern": "^https://[\\x20-\\x7E]{1,172}$",
      "maxLength": 180,
      "minLength": 9
     },
     "observedAt": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
     }
    },
    "additionalProperties": false
   },
   "maxItems": 60,
   "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": [
   {
    "brandCount": 2,
    "attribution": "submitted_unverified",
    "inputDigest": "9aa74ab3f54fed7193c72fa71539d52d1c05aeb0c71c0ec52eb71c362e04a73b",
    "resultDigest": "82b3c8bec5c2b82b40b10a6023ae47e9bfd98bd7fa2b318177f777f739786934",
    "totalSignals": 4,
    "schemaVersion": "1.0",
    "brandSummaries": [
     {
      "brandName": "Apple",
      "signalIds": [
       "apple-review-001",
       "apple-risk-001"
      ],
      "sourceUrls": [
       "https://example.org/apple-review",
       "https://example.org/apple-risk"
      ],
      "sourceHosts": [
       "example.org"
      ],
      "totalSignals": 2,
      "summaryDigest": "8d11b26b3b2e27151defc6a1f0c168be715fb8b2d3fa4a5e3586e5fa874e942a",
      "countsByStatus": {
       "active": 2,
       "resolved": 0
      },
      "countsBySeverity": {
       "low": 1,
       "high": 0,
       "medium": 0,
       "critical": 1
      },
      "countsByEventType": {
       "risk": 1,
       "other": 0,
       "hiring": 0,
       "review": 1,
       "inventory": 0,
       "promotion": 0,
       "regulatory": 0,
       "ad_campaign": 0,
       "price_change": 0,
       "product_launch": 0
      }
     },
     {
      "brandName": "Nike",
      "signalIds": [
       "nike-launch-001",
       "nike-price-001"
      ],
      "sourceUrls": [
       "https://example.com/nike-launch",
       "https://example.com/retail/nike-price"
      ],
      "sourceHosts": [
       "example.com"
      ],
      "totalSignals": 2,
      "summaryDigest": "15c98cf596a95c91763c7941e8d7ad2fb8c9628c8e1330b7d527928b3999819e",
      "countsByStatus": {
       "active": 1,
       "resolved": 1
      },
      "countsBySeverity": {
       "low": 0,
       "high": 1,
       "medium": 1,
       "critical": 0
      },
      "countsByEventType": {
       "risk": 0,
       "other": 0,
       "hiring": 0,
       "review": 0,
       "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-brand-summary-b28320cf/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)