# US Brand Action Queue (`zinin/us-brand-action-queue`) Actor

Turn verified US brand signals into one deterministic, prioritized action queue with evidence, ownership, urgency, and optional BYOK explanations.

- **URL**: https://apify.com/zinin/us-brand-action-queue.md
- **Developed by:** [Tim Zinin](https://apify.com/zinin) (community)
- **Categories:** Automation, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## US Brand Action Queue

Turn already verified US brand signals into one deterministic, prioritized action
queue. Each returned action keeps the evidence, urgency, ownership status, and rule
trace needed for a downstream operator or agent to decide what to do next.

### What you send

Send exactly one source:

- `items`: up to 500 verified US brand signals inline; or
- `datasetId`: one Apify Dataset selected with `READ` permission.

You may also send `requestId`, `scoredAt`, queue options, and an optional caller-owned
OpenRouter key for explanations. The source rows must already contain verified
attribution, evidence, timestamps, severity, state, and an owner when one is known.
This Actor does not discover or verify those source rows.

The source choice is exclusive. Supplying both `items` and `datasetId`, or neither,
is rejected. The input UI cannot express every cross-field rule, so the runtime is the
authoritative validator.

### What you get

For actionable input, the default Dataset receives one deterministic queue envelope.
Its actions are sorted and deduplicated, with priority score, urgency, action type,
owner information, evidence references, conflict references, and rule trace. The
run's default key-value store receives one `OUTPUT` receipt for every terminal state.

For empty or unusable input, the Actor returns a status-only receipt. It does not incur
the `result-found` charge, but every run still incurs the `apify-actor-start` event
charge from the selected pricing tier. A partial, invalid, unavailable, or
delivery-unknown state is reported explicitly; the Actor does not turn an uncertain
delivery into a successful result. The runtime field `free_status_only` means only
that no result event was charged; it does not mean that the run cost zero.

The hard limits are 500 source rows, 500 actions, 501 decoded Dataset probe rows, and
512 KiB for the returned queue envelope. The Dataset read uses one bounded page per
attempt at offset zero. The Actor does not browse source URLs, call another Actor,
use a proxy, maintain cross-run state, or guarantee replay/idempotency.

### Synthetic prefill

The Store input prefill is synthetic demonstration data. It is labelled as demo data
and is not a live Nike feed, live evidence, or a claim about Nike. Replace it with
your own verified rows and use `mode: "live"` for production input. The small example
below is a valid empty-input smoke test and therefore produces no paid queue result.

#### Input JSON

```json
{
  "schemaVersion": "1.0",
  "requestId": "quickstart-empty",
  "scoredAt": "2026-08-05T00:00:00Z",
  "items": []
}
```

#### OUTPUT JSON

```json
{
  "schemaVersion": "1.0",
  "actor": "us-brand-action-queue",
  "requestId": "quickstart-empty",
  "requestDigest": "sha256:1ec50135a198aebbbd26f8a8ab5f49f37aa13485fe05ea67680a86bd26a63d5d",
  "scoredAt": "2026-08-05T00:00:00Z",
  "queueId": null,
  "status": "no_actionable_signals",
  "runTerminalState": "SUCCEEDED",
  "resultFound": false,
  "partial": false,
  "actionCount": 0,
  "inputCount": 0,
  "probeItemCount": 0,
  "deduplicatedCount": 0,
  "rejectedCount": 0,
  "conflictCount": 0,
  "billedResultCount": 0,
  "datasetWriteCount": 0,
  "source": { "kind": "items", "datasetId": null },
  "limits": { "maxItems": 500, "maxActions": 500, "maxBytes": 524288, "truncated": false },
  "analysisStatus": "skipped_no_key",
  "errors": [],
  "delivery": {
    "state": "free_status_only",
    "attemptedPushCount": 0,
    "chargedCount": 0,
    "resultChargeCountBefore": null,
    "resultChargeCountAfter": null,
    "aggregateChargedCount": null,
    "eventChargeLimitReached": null,
    "datasetItemBillingEvent": null
  }
}
```

A non-empty, valid input produces `status: "queue_found"`, `resultFound: true`, one
Dataset queue envelope, and one paid `result-found` event. The following is a
synthetic shape example of that successful receipt; it is not a live run receipt.

```json
{
  "schemaVersion": "1.0",
  "actor": "us-brand-action-queue",
  "requestId": "synthetic-action-queue-001",
  "requestDigest": "sha256:3288949ccbfea1ca0dfbe7bf99c1d1ce252eada47d0f595c982e0ca213f9bc24",
  "scoredAt": "2026-08-05T00:00:00Z",
  "queueId": "sha256:0c099618e3c4aa651fde83c1eacf924cbbe0718898856963d04f41d46f7256d0",
  "status": "queue_found",
  "runTerminalState": "SUCCEEDED",
  "resultFound": true,
  "partial": false,
  "actionCount": 1,
  "inputCount": 2,
  "probeItemCount": 2,
  "deduplicatedCount": 1,
  "rejectedCount": 0,
  "conflictCount": 0,
  "billedResultCount": 1,
  "datasetWriteCount": 1,
  "source": { "kind": "items", "datasetId": null },
  "limits": { "maxItems": 500, "maxActions": 500, "maxBytes": 524288, "truncated": false },
  "analysisStatus": "skipped_no_key",
  "errors": [],
  "delivery": {
    "state": "confirmed_paid_result",
    "attemptedPushCount": 1,
    "chargedCount": 1,
    "resultChargeCountBefore": 0,
    "resultChargeCountAfter": 1,
    "aggregateChargedCount": 2,
    "eventChargeLimitReached": true,
    "datasetItemBillingEvent": null
  }
}
```

### Billing and six-tier discounts

The start event is charged once per run. A non-empty queue is charged once for the
single linked `result-found` event only after the result-event counter increases by
exactly one around delivery. Dataset item pricing is not used. The start charge is
already included in platform spend; the result price below is the only additional
charge checked before a successful delivery.

| Tier | Discount | Start event | Result event | Start plus one result |
|---|---:|---:|---:|---:|
| FREE | 0% | $0.00500 | $0.02000 | $0.02500 |
| BRONZE | 5% | $0.00475 | $0.01900 | $0.02375 |
| SILVER | 10% | $0.00450 | $0.01800 | $0.02250 |
| GOLD | 15% | $0.00425 | $0.01700 | $0.02125 |
| PLATINUM | 18% | $0.00410 | $0.01640 | $0.02050 |
| DIAMOND | 20% | $0.00400 | $0.01600 | $0.02000 |

If the result counter is zero after a returned push, the receipt is
`budget_stopped`. If the counter is unreadable, the push throws, or the delta is not
exactly one, the receipt is `delivery_unknown` and no retry is made in that run.
Separate runs are separate purchases even when they use the same `requestId`.

### BYOK explanations

BYOK is optional and affects explanations only. When `options.explanation` is
`"byok"`, provide `openrouterApiKey` and the allowlisted model
`openai/gpt-4o-mini`. The Actor makes at most one request to
`https://openrouter.ai/api/v1/chat/completions`, projects at most 25 actions, limits
the response to 600 output tokens, and applies a ten-second provider deadline.

The key is caller-supplied, is not stored in the queue or receipt, and is not written
to logs. Provider quota and provider billing remain the caller's responsibility.
Provider failures never become an authority for queue identity, attribution, billing,
or the result-event decision. An HTTP 401, 402, or 429 response completed within the
deadline proceeds to normal queue pricing and delivery with `analysisStatus` set to
`error_401`, `error_402`, or `error_429`; another bounded provider failure uses
`error_provider` and follows the same path.

The elapsed-time boundary is strict. A generic provider completion/error, including
HTTP 408, observed at exactly `10,000 ms` remains `error_provider` and can be delivered
through normal pricing and delivery. Only an observed elapsed time greater than
`10,000 ms` maps to `error_timeout`; it then fails the mandatory runtime deadline gate
and terminates with `status: "source_unavailable"`, `errors: ["deadline_exceeded"]`,
`runTerminalState: "FAILED"`, and no queue delivery or `result-found` push.

### API

The following request uses only the README-contained empty-input JSON. Replace the
input with your verified signals for a queue result.

```sh
curl -sS -X POST 'https://api.apify.com/v2/acts/zinin~us-brand-action-queue/runs?waitForFinish=60' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{
    "schemaVersion": "1.0",
    "requestId": "quickstart-empty",
    "scoredAt": "2026-08-05T00:00:00Z",
    "items": []
  }'
```

After the run, read the run's default Dataset and the `OUTPUT` record from its
default key-value store. Treat `OUTPUT` as authoritative for terminal status before
assuming that a Dataset item was delivered.

```sh
curl -sS "https://api.apify.com/v2/datasets/$DEFAULT_DATASET_ID/items?clean=true&format=json" \
  -H "Authorization: Bearer $APIFY_TOKEN"

curl -sS "https://api.apify.com/v2/key-value-stores/$DEFAULT_KVS_ID/records/OUTPUT" \
  -H "Authorization: Bearer $APIFY_TOKEN"
```

### Machine and agent use

The closed JSON input, bounded work, stable status enum, deterministic queue identity,
and explicit `OUTPUT` receipt are suitable for scheduled jobs and agent workflows.
An agent can call the Actor through the Apify API, JavaScript SDK, or an MCP client
that exposes the standard Apify `call-actor` operation:

```json
{
  "name": "call-actor",
  "arguments": {
    "actor": "zinin/us-brand-action-queue",
    "input": {
      "schemaVersion": "1.0",
      "requestId": "quickstart-empty",
      "scoredAt": "2026-08-05T00:00:00Z",
      "items": []
    }
  }
}
```

The agent should branch on `OUTPUT.status`, stop on `delivery_unknown`, and avoid
blind retries. This section describes the call shape only and makes no statement
about separate MCP, x402, or other catalogue registration.

### Related Actors

The following five zinin Store Actors form the approved public crosslink allowlist.
They are useful upstream or adjacent sources for the action queue.

| Actor | Store slug | Relationship | Availability |
|---|---|---|---|
| [Intent Signal Aggregator](https://apify.com/zinin/intent-signal-aggregator) | `zinin/intent-signal-aggregator` | Supplies intent signals that can be converted into prioritized brand actions. | Public Store Actor |
| [Company Profile Lookup](https://apify.com/zinin/company-lookup) | `zinin/company-lookup` | Adds company identity and profile context to a verified brand signal. | Public Store Actor |
| [Shopify Store Intelligence](https://apify.com/zinin/shopify-store-intelligence) | `zinin/shopify-store-intelligence` | Supplies commerce and store signals for brand or competitor workflows. | Public Store Actor |
| [Funding Round Tracker](https://apify.com/zinin/funding-round-tracker) | `zinin/funding-round-tracker` | Supplies funding events that can trigger an outreach or monitoring action. | Public Store Actor |
| [Patent Filing Monitor](https://apify.com/zinin/patent-monitor) | `zinin/patent-monitor` | Supplies patent signals that can be routed into a brand intelligence queue. | Public Store Actor |

### Boundaries

This Actor does not establish legal ownership, verify a brand independently, make a
compliance or investment decision, or guarantee that source evidence is complete. It
does not fetch or dereference evidence URLs, use proxies, call external Actors, or
retain public state. Review the supplied evidence and apply your own decision rules.

Built by [zinin](https://apify.com/zinin).

# Actor input Schema

## `schemaVersion` (type: `string`):

Closed contract version.

## `scoredAt` (type: `string`):

Explicit timestamp bound into request identity and used by all time-based scoring rules.

## `requestId` (type: `string`):

Bounded correlation value only; it does not deduplicate separate Actor runs.

## `items` (type: `array`):

Choose this or datasetId, never both; the runtime enforces XOR because the Apify schema dialect cannot express cross-property relations.

## `datasetId` (type: `string`):

Choose this or items, never both; the runtime enforces XOR because the Apify schema dialect cannot express cross-property relations.

## `options` (type: `object`):

Deterministic caps and optional explanation mode.

## `openrouterApiKey` (type: `string`):

Optional caller-supplied value for one bounded explanation only; runtime enforces the BYOK conditional because the Apify schema dialect cannot express it.

## Actor input object example

```json
{
  "schemaVersion": "1.0",
  "scoredAt": "2026-08-05T00:00:00Z",
  "requestId": "action-queue-20260804-001",
  "items": [
    {
      "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
    }
  ],
  "options": {
    "mode": "demo",
    "maxItems": 10,
    "maxActions": 10,
    "includeResolved": true,
    "explanation": "off"
  }
}
```

# Actor output Schema

## `OUTPUT` (type: `string`):

API link to the closed terminal receipt.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "scoredAt": "2026-08-05T00:00:00Z",
    "requestId": "action-queue-20260804-001",
    "items": [
        {
            "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
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zinin/us-brand-action-queue").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "scoredAt": "2026-08-05T00:00:00Z",
    "requestId": "action-queue-20260804-001",
    "items": [
        {
            "entityId": "nike.com",
            "brandName": "Nike",
            "legalName": "Nike, Inc.",
            "domain": "nike.com",
            "ticker": "NKE",
            "cik": None,
            "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": None,
            "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,
        },
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("zinin/us-brand-action-queue").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "scoredAt": "2026-08-05T00:00:00Z",
  "requestId": "action-queue-20260804-001",
  "items": [
    {
      "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
    }
  ]
}' |
apify call zinin/us-brand-action-queue --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zinin/us-brand-action-queue",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AT0kZbLRM21VwDfRv/builds/oCAOxEyDhs5qd9hCy/openapi.json
