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.

Operations 1

POST /api/us-brand-signal-brand-summary US Brand Signal Brand Summary #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/timzinin-com:timzinin-com-us-brand-signal-brand-summary-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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 Specification

timzinin-com-us-brand-signal-brand-summary-api-openapi.yml Raw ↑
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