{"uid":"cap_ysyx0koVoghuLBpysgsvP","slug":"us-brand-signal-metrics-aggregator-15b9b047","name":"US Brand Signal Metrics Aggregator","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/us-brand-signal-metrics-aggregator","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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}}]}},"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_4-Zrdt_ngL8gct1N7R3KH","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 signal metrics for US brands, returning counts, severities, confidence scores, and event-type breakdowns across monitoring sources.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Brand risk monitoring for retail team","prompt":"Can you check the current brand signal metrics for our US retail brand and tell me how many high or critical risk signals are active, what the average confidence score is in basis points, and if there are any regulatory or review signals I should be worried about?"},{"title":"Competitive intelligence on price changes","prompt":"Pull together the brand signal metrics for this US brand and break down the signals by event type — I specifically want to know if there are any active price change or promotion signals, and how many are flagged as high confidence."},{"title":"Brand health snapshot for weekly report","prompt":"I need a brand health summary for our weekly report — aggregate the brand signals for our US brand and give me the total count, how many are active versus resolved, the severity breakdown across low, medium, and high, and which monitoring sources they came from."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:32.548Z","isFirstParty":false}