timzinin-com Us Brand Action Queue API
The Us Brand Action Queue API from timzinin-com — 1 operation(s) for us brand action queue.
The Us Brand Action Queue API from timzinin-com — 1 operation(s) for us brand action queue.
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-action-queue-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 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