timzinin-com Us Brand Action Queue API

The Us Brand Action Queue API from timzinin-com — 1 operation(s) for us brand action queue.

Operations 1

POST /api/us-brand-action-queue US Brand Action Queue #

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-action-queue-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-action-queue-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Zinin M2M Hub Us Brand Action Queue 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 Action Queue
paths:
  /api/us-brand-action-queue:
    post:
      summary: US Brand Action Queue
      description: Turn verified US brand signals into one deterministic prioritized action queue with evidence, urgency, ownership status, and rule traces for downstream operators and agents. The Actor does not send messages or write to destinations.
      operationId: call_us_brand_action_queue
      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 Action Queue input
              description: Exactly one inline verified signal list or one explicitly selected read-only Dataset.
              type: object
              schemaVersion: 1
              additionalProperties: false
              required:
              - schemaVersion
              - scoredAt
              properties:
                schemaVersion:
                  title: Contract schema version
                  description: Closed contract version.
                  type: string
                  enum:
                  - '1.0'
                  default: '1.0'
                scoredAt:
                  title: Scoring timestamp
                  description: Explicit UTC timestamp bound into request identity and used by all time-based scoring rules.
                  type: string
                  editor: textfield
                  pattern: ^(?!0000)\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{3})?Z$
                  minLength: 20
                  maxLength: 24
                  default: '2026-08-05T00:00:00Z'
                  prefill: '2026-08-05T00:00:00Z'
                requestId:
                  title: Request ID
                  description: Bounded correlation value only; it does not deduplicate separate Actor runs.
                  type: string
                  editor: textfield
                  minLength: 1
                  maxLength: 128
                  prefill: action-queue-20260804-001
                items:
                  title: Inline verified fleet signals
                  type: array
                  description: Choose this or datasetId, never both; the runtime enforces XOR because the Apify schema dialect cannot express cross-property relations.
                  editor: json
                  maxItems: 500
                  items:
                    type: object
                    additionalProperties: false
                    required:
                    - entityId
                    - brandName
                    - legalName
                    - domain
                    - ticker
                    - cik
                    - aliases
                    - country
                    - sourceEntityIds
                    - eventType
                    - eventId
                    - observedAt
                    - effectiveAt
                    - sourceName
                    - sourceUrl
                    - sourceRecordId
                    - evidence
                    - confidence
                    - severity
                    - state
                    - dedupeKey
                    - attribution
                    - owner
                    - analysisStatus
                    - demoFixture
                    properties:
                      entityId:
                        type: string
                        minLength: 1
                        maxLength: 128
                      brandName:
                        type: string
                        minLength: 1
                        maxLength: 2048
                      legalName:
                        type:
                        - string
                        - 'null'
                        maxLength: 2048
                      domain:
                        type:
                        - string
                        - 'null'
                        maxLength: 2048
                      ticker:
                        type:
                        - string
                        - 'null'
                        maxLength: 64
                      cik:
                        type:
                        - string
                        - 'null'
                        maxLength: 32
                      aliases:
                        type: array
                        maxItems: 20
                        items:
                          type: string
                          minLength: 1
                          maxLength: 2048
                      country:
                        type: string
                        enum:
                        - US
                      sourceEntityIds:
                        type: array
                        minItems: 1
                        maxItems: 20
                        items:
                          type: string
                          minLength: 1
                          maxLength: 128
                      eventType:
                        type: string
                        enum:
                        - regulatory_action
                        - recall
                        - safety_incident
                        - availability_change
                        - inventory_change
                        - price_change
                        - promotion_change
                        - product_launch
                        - ad_change
                        - review_spike
                        - store_change
                        - hiring_change
                        - site_change
                        - news_item
                        - trademark_filing
                        - other
                      eventId:
                        type: string
                        minLength: 1
                        maxLength: 128
                      observedAt:
                        type: string
                        maxLength: 64
                      effectiveAt:
                        type:
                        - string
                        - 'null'
                        maxLength: 64
                      sourceName:
                        type: string
                        minLength: 1
                        maxLength: 2048
                      sourceUrl:
                        type: string
                        pattern: ^https://
                        maxLength: 2048
                      sourceRecordId:
                        type: string
                        minLength: 1
                        maxLength: 128
                      evidence:
                        type: object
                        additionalProperties: false
                        required:
                        - facts
                        - excerpt
                        - additionalUrls
                        properties:
                          facts:
                            type: object
                            maxProperties: 20
                            propertyNames:
                              type: string
                              pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$
                            additionalProperties:
                              anyOf:
                              - type: string
                                maxLength: 1024
                              - type: number
                                minimum: -1000000000000
                                maximum: 1000000000000
                              - type: boolean
                              - type: 'null'
                          excerpt:
                            type: string
                            maxLength: 8192
                          additionalUrls:
                            type: array
                            maxItems: 20
                            items:
                              type: string
                              pattern: ^https://
                              maxLength: 2048
                      confidence:
                        type: number
                        minimum: 0
                        maximum: 1
                      severity:
                        type: string
                        enum:
                        - critical
                        - high
                        - medium
                        - low
                        - unknown
                      state:
                        type: string
                        enum:
                        - active
                        - pending
                        - resolved
                        - informational
                        - unknown
                      dedupeKey:
                        type: string
                        minLength: 1
                        maxLength: 128
                      attribution:
                        type: object
                        additionalProperties: false
                        required:
                        - status
                        - proofType
                        - proofValue
                        - sourceEntityId
                        properties:
                          status:
                            type: string
                            const: verified_by_source
                          proofType:
                            type: string
                            enum:
                            - exact-domain
                            - source-account-id
                            - official-link
                            - registry-id
                          proofValue:
                            type: string
                            minLength: 1
                            maxLength: 2048
                          sourceEntityId:
                            type: string
                            minLength: 1
                            maxLength: 128
                      owner:
                        type:
                        - object
                        - 'null'
                        additionalProperties: false
                        required:
                        - ownerType
                        - ownerId
                        - label
                        - source
                        properties:
                          ownerType:
                            type: string
                            minLength: 1
                            maxLength: 2048
                          ownerId:
                            type: string
                            minLength: 1
                            maxLength: 2048
                          label:
                            type: string
                            minLength: 1
                            maxLength: 2048
                          source:
                            type: string
                            minLength: 1
                            maxLength: 2048
                      analysisStatus:
                        type: string
                        const: not_requested
                      demoFixture:
                        type: boolean
                  prefill:
                  - entityId: nike.com
                    brandName: Nike
                    legalName: Nike, Inc.
                    domain: nike.com
                    ticker: NKE
                    cik: null
                    aliases:
                    - Nike, Inc.
                    country: US
                    sourceEntityIds:
                    - us-dtc-product-launch-monitor:nike.com
                    eventType: product_launch
                    eventId: fixture-launch-001
                    observedAt: '2026-08-04T10:00:00Z'
                    effectiveAt: '2026-08-04T10:00:00Z'
                    sourceName: prefill_fixture
                    sourceUrl: https://www.nike.com/
                    sourceRecordId: fixture-launch-001
                    evidence:
                      facts:
                        productName: Fixture running shoe
                        price: 120
                      excerpt: Synthetic Store prefill evidence; not a live fetch
                      additionalUrls: []
                    confidence: 0.96
                    severity: high
                    state: active
                    dedupeKey: prefill_fixture|nike.com|product_launch|fixture-launch-001
                    attribution:
                      status: verified_by_source
                      proofType: exact-domain
                      proofValue: nike.com
                      sourceEntityId: us-dtc-product-launch-monitor:nike.com
                    owner:
                      ownerType: team
                      ownerId: merchandising
                      label: Merchandising
                      source: customer
                    analysisStatus: not_requested
                    demoFixture: true
                  - entityId: nike.com
                    brandName: Nike
                    legalName: Nike, Inc.
                    domain: nike.com
                    ticker: NKE
                    cik: null
                    aliases:
                    - Nike, Inc.
                    country: US
                    sourceEntityIds:
                    - us-dtc-product-launch-monitor:nike.com
                    eventType: product_launch
                    eventId: fixture-launch-001
                    observedAt: '2026-08-04T10:00:00Z'
                    effectiveAt: '2026-08-04T10:00:00Z'
                    sourceName: prefill_fixture
                    sourceUrl: https://www.nike.com/
                    sourceRecordId: fixture-launch-001
                    evidence:
                      facts:
                        productName: Fixture running shoe
                        price: 120
                      excerpt: Synthetic Store prefill evidence; not a live fetch
                      additionalUrls: []
                    confidence: 0.96
                    severity: high
                    state: active
                    dedupeKey: prefill_fixture|nike.com|product_launch|fixture-launch-001
                    attribution:
                      status: verified_by_source
                      proofType: exact-domain
                      proofValue: nike.com
                      sourceEntityId: us-dtc-product-launch-monitor:nike.com
                    owner:
                      ownerType: team
                      ownerId: merchandising
                      label: Merchandising
                      source: customer
                    analysisStatus: not_requested
                    demoFixture: true
                datasetId:
                  title: Authorized source Dataset
                  type: string
                  description: Choose this or items, never both; the runtime enforces XOR because the Apify schema dialect cannot express cross-property relations.
                  editor: resourcePicker
                  resourceType: dataset
                  resourcePermissions:
                  - READ
                  pattern: ^[A-Za-z0-9][A-Za-z0-9._~-]{0,99}$
                  minLength: 1
                  maxLength: 100
                options:
                  title: Queue options
                  description: Deterministic caps and optional explanation mode.
                  editor: json
                  type: object
                  additionalProperties: false
                  default:
                    mode: demo
                    maxItems: 10
                    maxActions: 10
                    includeResolved: true
                    explanation: 'off'
                  properties:
                    mode:
                      title: Mode
                      description: Demo accepts synthetic-labeled rows; live rejects them.
                      type: string
                      enum:
                      - live
                      - demo
                      default: live
                    maxItems:
                      title: Maximum source items
                      description: Maximum source rows before normalization.
                      type: integer
                      minimum: 1
                      maximum: 500
                      default: 100
                    maxActions:
                      title: Maximum actions
                      description: Maximum queue actions; truncation is non-paid.
                      type: integer
                      minimum: 1
                      maximum: 500
                      default: 100
                    includeResolved:
                      title: Include resolved
                      description: Keep resolved rows in the queue.
                      type: boolean
                      default: false
                    explanation:
                      title: Explanation mode
                      description: Off or one bounded caller-supplied explanation pass.
                      type: string
                      enum:
                      - 'off'
                      - byok
                      default: 'off'
                    analysisModel:
                      title: Explanation model
                      description: One allowlisted model identifier; omitted means null.
                      type: string
                      enum:
                      - openai/gpt-4o-mini
                openrouterApiKey:
                  title: Optional explanation input
                  type: string
                  description: Optional caller-supplied value for one bounded explanation only; runtime enforces the BYOK conditional because the Apify schema dialect cannot express it.
                  editor: textfield
                  isSecret: true
                  minLength: 1
                  maxLength: 4096
      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 Action Queue