{"uid":"cap_GN_TRlVnO_RmS6tbwHYNc","slug":"us-brand-signal-brand-summary-b28320cf","name":"US Brand Signal Brand Summary","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/us-brand-signal-brand-summary","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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}}]}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3ez1HENXXy04zRsaAl5us","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Competitive brand risk monitoring","prompt":"I need a brand signal summary for Tesla — show me how many signals are active vs resolved, and flag anything at critical or high severity so I can see if there are major risks in play."},{"title":"Product launch and price change tracking","prompt":"Pull the brand signal digest for Nike and tell me how many product launch and price change signals have been captured, and which source URLs they came from."},{"title":"Multi-brand market intelligence report","prompt":"Can you get me brand summaries for Apple and Samsung? I want a breakdown of their signals by event type — especially reviews, regulatory events, and ad campaigns — so I can put together a competitive landscape report."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:45:32.630Z","isFirstParty":false}