timzinin-com Us Brand Signal Brand Summary API
The Us Brand Signal Brand Summary API from timzinin-com — 1 operation(s) for us brand signal brand summary.
The Us Brand Signal Brand Summary API from timzinin-com — 1 operation(s) for us brand signal brand summary.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/timzinin-com:timzinin-com-us-brand-signal-brand-summary-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Zinin M2M Hub Us Brand Signal Brand Summary API
description: Pay-per-call data & tool APIs
version: 1.0.0
x-guidance: 'Zinin M2M Hub — pay-per-call data & tool APIs for AI agents. Each POST /api/{slug} operation below is a distinct paid tool: call GET /api/{slug}/schema first for the exact input shape, then POST with a signed PAYMENT-SIGNATURE header (x402 v2, USDC — see x-payment-info per operation) or omit it to receive a 402 with full payment requirements in the PAYMENT-REQUIRED header. The same catalog is also available as MCP JSON-RPC tool bundles at POST /mcp/{bundle} — see GET /.well-known/x402 for the list of bundles.'
tags:
- name: Us Brand Signal Brand Summary
paths:
/api/us-brand-signal-brand-summary:
post:
summary: US Brand Signal Brand Summary
description: Summarize 1 to 60 buyer-supplied normalized US brand signals for up to 15 explicit brands. Receive deterministic counts and grouped facts without identity resolution, source verification, browsing, or live enrichment.
operationId: call_us_brand_signal_brand_summary
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.050000'
protocols:
- x402: {}
network: eip155:8453
payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
requestBody:
required: true
content:
application/json:
schema:
title: US Brand Signal Brand Summary input
description: Provide 1-60 closed normalized rows for up to 15 explicit brands. All values are inline buyer data.
type: object
schemaVersion: 1
additionalProperties: false
required:
- schemaVersion
- rows
properties:
schemaVersion:
title: Contract schema version
description: Required closed V1 contract.
type: string
editor: select
enum:
- '1.0'
default: '1.0'
prefill: '1.0'
rows:
title: Normalized signal rows
description: One to 60 unique signal rows. brandName is explicit and input order is ignored.
type: array
editor: json
minItems: 1
maxItems: 60
items:
type: object
additionalProperties: false
required:
- signalId
- brandName
- eventType
- severity
- status
- observedAt
- sourceUrl
properties:
signalId:
title: Signal ID
description: Unique printable ASCII signal identifier.
type: string
minLength: 1
maxLength: 64
pattern: ^[\x20-\x7E]{1,64}$
brandName:
title: Explicit brand name
description: Buyer-supplied identity label; never inferred.
type: string
minLength: 1
maxLength: 48
pattern: ^[\x20-\x7E]{1,48}$
eventType:
title: Event type
description: Closed normalized event category.
type: string
enum:
- product_launch
- price_change
- promotion
- inventory
- ad_campaign
- review
- risk
- regulatory
- hiring
- other
severity:
title: Severity
description: Closed normalized severity.
type: string
enum:
- low
- medium
- high
- critical
status:
title: Status
description: Closed normalized status.
type: string
enum:
- active
- resolved
observedAt:
title: Observed at
description: UTC Gregorian timestamp supplied by the buyer.
type: string
pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$
sourceUrl:
title: HTTPS source URL
description: Buyer-supplied HTTPS provenance URL; it is never fetched.
type: string
minLength: 9
maxLength: 180
pattern: ^https://[\x20-\x7E]{1,172}$
prefill:
- signalId: nike-launch-001
brandName: Nike
eventType: product_launch
severity: high
status: active
observedAt: '2024-02-29T12:00:00Z'
sourceUrl: https://example.com/nike-launch
- signalId: nike-price-001
brandName: Nike
eventType: price_change
severity: medium
status: resolved
observedAt: '2024-03-01T12:00:00Z'
sourceUrl: https://example.com/retail/nike-price
- signalId: apple-risk-001
brandName: Apple
eventType: risk
severity: critical
status: active
observedAt: '2024-03-02T12:00:00Z'
sourceUrl: https://example.org/apple-risk
- signalId: apple-review-001
brandName: Apple
eventType: review
severity: low
status: active
observedAt: '2024-03-03T12:00:00Z'
sourceUrl: https://example.org/apple-review
responses:
'200':
description: Actor run succeeded and payment settled
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
description: Actor output items — shape is actor-specific (varies per tool); see this operation's own requestBody schema/description for what the underlying actor produces.
meta:
type: object
properties:
run_ms:
type: integer
description: Actor run duration in milliseconds
item_count:
type: integer
description: len(results)
settled:
type: boolean
description: Whether the x402 payment was confirmed settled by the facilitator
transaction:
type:
- string
- 'null'
description: On-chain settlement transaction hash, null if unsettled
required:
- run_ms
- item_count
- settled
- transaction
required:
- results
- meta
'400':
description: Malformed PAYMENT-SIGNATURE header or request body
'402':
description: Payment required or invalid — see PAYMENT-REQUIRED header
'409':
description: Payment payload already used
'502':
description: Actor run failed
'504':
description: Actor run timed out
tags:
- Us Brand Signal Brand Summary