timzinin-com Us Brand Signal Webhook Payload Builder API

The Us Brand Signal Webhook Payload Builder API from timzinin-com — 1 operation(s) for us brand signal webhook payload builder.

Operations 1

POST /api/us-brand-signal-webhook-payload-builder US Brand Signal Webhook Payload Builder #

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-webhook-payload-builder-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-webhook-payload-builder-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Zinin M2M Hub Us Brand Signal Webhook Payload Builder 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 Webhook Payload Builder
paths:
  /api/us-brand-signal-webhook-payload-builder:
    post:
      summary: US Brand Signal Webhook Payload Builder
      description: Build one bounded deterministic unsent payload shaped for Slack, Teams, or a generic webhook from one normalized signal and buyer-supplied evidence. The Actor never sends a webhook or accepts a destination.
      operationId: call_us_brand_signal_webhook_payload_builder
      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 Webhook Payload Builder input
              description: Closed inline-only input. Supply one normalized signal, a target enum, and a small allowlisted presentation configuration. This Actor never sends anything.
              type: object
              schemaVersion: 1
              additionalProperties: false
              required:
              - schemaVersion
              - signal
              - target
              - presentation
              properties:
                schemaVersion:
                  title: Contract schema version
                  description: The only supported closed contract version.
                  type: string
                  enum:
                  - '1.0'
                  default: '1.0'
                  prefill: '1.0'
                signal:
                  title: One normalized signal and evidence object
                  description: Buyer-provided text and one to three HTTPS evidence records. No identity or live-source lookup is performed.
                  type: object
                  editor: json
                  additionalProperties: false
                  required:
                  - signalId
                  - signalType
                  - headline
                  - summary
                  - severity
                  - occurredAt
                  - evidence
                  properties:
                    signalId:
                      title: Opaque signal ID
                      description: Printable opaque identifier; no identity lookup is performed.
                      type: string
                      minLength: 1
                      maxLength: 64
                      pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$
                    signalType:
                      title: Signal type
                      description: Closed signal category enum.
                      type: string
                      enum:
                      - brand_mention
                      - price_change
                      - recall
                      - regulatory
                      - availability
                      - other
                    headline:
                      title: Headline
                      description: Buyer-supplied headline, without control characters.
                      type: string
                      minLength: 1
                      maxLength: 200
                    summary:
                      title: Summary
                      description: Buyer-supplied bounded summary, without control characters.
                      type: string
                      minLength: 1
                      maxLength: 2000
                    severity:
                      title: Severity
                      description: Closed severity enum.
                      type: string
                      enum:
                      - low
                      - medium
                      - high
                      - critical
                    occurredAt:
                      title: Occurred UTC timestamp
                      description: Strict UTC timestamp in YYYY-MM-DDTHH:mm:ssZ form.
                      type: string
                      pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
                    evidence:
                      title: Evidence records
                      description: One to three buyer-supplied HTTPS attribution records; pages are not fetched.
                      type: array
                      minItems: 1
                      maxItems: 3
                      items:
                        type: object
                        additionalProperties: false
                        required:
                        - url
                        - title
                        - capturedAt
                        properties:
                          url:
                            title: HTTPS evidence URL
                            description: HTTPS attribution URL without credentials or a non-default port.
                            type: string
                            minLength: 12
                            maxLength: 2048
                            pattern: ^https://
                          title:
                            title: Evidence title
                            description: Buyer-supplied evidence label.
                            type: string
                            minLength: 1
                            maxLength: 160
                          capturedAt:
                            title: Evidence capture UTC timestamp
                            description: Strict UTC timestamp.
                            type: string
                            pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
                  prefill:
                    signalId: nike-recall-001
                    signalType: recall
                    headline: Example brand recall signal
                    summary: Buyer-supplied signal for a downstream review workflow.
                    severity: high
                    occurredAt: '2026-08-05T12:00:00Z'
                    evidence:
                    - url: https://example.com/evidence/recall-001
                      title: Buyer evidence record
                      capturedAt: '2026-08-05T12:05:00Z'
                target:
                  title: Payload target
                  description: A closed enum only. This selects a local JSON shape; it never supplies a destination.
                  type: string
                  enum:
                  - slack
                  - teams
                  - generic
                  default: slack
                  prefill: slack
                presentation:
                  title: Allowlisted presentation settings
                  description: Only these booleans, style enum, and bounded character limit are accepted. Templates and expressions are not supported.
                  type: object
                  editor: json
                  additionalProperties: false
                  required:
                  - includeHeadline
                  - includeSummary
                  - includeSeverity
                  - includeSource
                  - includeOccurredAt
                  - maxContentChars
                  - style
                  properties:
                    includeHeadline:
                      title: Include headline
                      description: Include the normalized headline in text content.
                      type: boolean
                      default: true
                    includeSummary:
                      title: Include summary
                      description: Include the normalized summary in text content.
                      type: boolean
                      default: true
                    includeSeverity:
                      title: Include severity
                      description: Include the normalized severity in text content.
                      type: boolean
                      default: true
                    includeSource:
                      title: Include source
                      description: Include source labels and HTTPS evidence links in text content.
                      type: boolean
                      default: true
                    includeOccurredAt:
                      title: Include occurred time
                      description: Include the buyer-supplied UTC occurredAt value in text content.
                      type: boolean
                      default: true
                    maxContentChars:
                      title: Maximum content characters
                      description: Bounded deterministic output text limit from 120 through 1200 characters.
                      type: integer
                      minimum: 120
                      maximum: 1200
                      default: 600
                    style:
                      title: Presentation style
                      description: Closed formatting style enum; no templates or expressions.
                      type: string
                      enum:
                      - compact
                      - standard
                      default: standard
                  prefill:
                    includeHeadline: true
                    includeSummary: true
                    includeSeverity: true
                    includeSource: true
                    includeOccurredAt: true
                    maxContentChars: 600
                    style: standard
      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 Webhook Payload Builder