# Shopify WooCommerce DTC Catalog Intelligence (`zentrafoundry/shopify-woocommerce-dtc-catalog-intelligence`) Actor

Extract and monitor public Shopify and WooCommerce product catalogs, variants, prices, collections, review app hints, and catalog changes.

- **URL**: https://apify.com/zentrafoundry/shopify-woocommerce-dtc-catalog-intelligence.md
- **Developed by:** [Zentra](https://apify.com/zentrafoundry) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 85.7% 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.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use 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

## Shopify WooCommerce DTC Catalog Intelligence

Compare Shopify Products Json, Woocommerce Public Catalog, Schema Org Product and return product change rows with price, stock, availability, seller, and source evidence.

### What this Actor does

### What it does

- Processes configured public sources or user-provided records for focused shopify woocommerce dtc catalog intelligence monitoring.
- Emits structured rows with source references, stable identifiers, confidence, warnings, and run summary fields.
- Supports sample-mode runs so Apify Store QA and first-time users can inspect output without depending on live third-party availability.

### What it does not do

- Does not scrape private, login-only, paywalled, or access-restricted data unless the user provides approved credentials for a source they control.
- Does not guarantee every field is available from every source; missing or blocked fields are returned as warnings or nulls.
- Does not make legal, financial, compliance, procurement, medical, safety, or regulatory decisions.

### Who this is for

E-commerce, marketplace, pricing, merchandising, product, and market research teams use this actor when they need focused shopify woocommerce dtc catalog intelligence output instead of a broad generic scraper or manual checking.

### Buyer outcomes

- Detect shopify woocommerce dtc catalog intelligence product changes without manually comparing product scraper runs or catalog snapshots.
- Prioritize action with product identifiers, current/previous price, availability, stock state, seller context, confidence, and source URL.
- Route product-change records into pricing, merchandising, competitive intelligence, alerting, or marketplace operations workflows.

### Data sources

### Sources monitored

- [Shopify Products Json](https://shopify.dev/docs/api/ajax/reference/product)
- [Woocommerce Public Catalog](https://woocommerce.com/document/woocommerce-rest-api/)
- [Schema Org Product](https://schema.org/Product)

### Input

- `sourceMode`: use `sample` for a smoke run or `startUrls` for product pages, scraper dataset docs, catalog snapshots, or pricing sources.
- `startUrls`: product, SKU, marketplace, catalog, pricing, availability, stock, review, or scraper-output URLs.
- `sourceIds`: approved product, marketplace, catalog, or dataset source identifiers.
- `maxItems`: bounded number of product records or product changes to return.
- `sinceLastRun`: emit only new or changed product states when scheduled.
- `watchlistTerms`: SKU, product, brand, seller, price, stock, availability, or category terms.
- `webhookUrl`: optional destination for price, stock, availability, or catalog-change alerts.

### How it transforms the input

- Input: product scraper dataset, product page, catalog snapshot, marketplace listing, pricing feed, or availability record.
- Transformation: normalize product identifiers and compare price, stock, availability, seller, title, rating, or shipping fields.
- Output: product-change record with product identifier, product name, current/previous price, availability, stock state, change type, timestamp, source URL, and confidence.

### Output

The actor returns e-commerce product-change records with product identifiers, product names, current and previous prices, stock state, availability, seller context, source URLs, timestamps, and confidence.

Family-specific fields to expect:

- `productIdentifier`: Stable product, SKU, listing, or catalog identifier.
- `productName`: Product or listing name.
- `currentPrice`: Current observed price when available.
- `previousPrice`: Previous observed price when change tracking is available.
- `currency`: Currency for price fields.
- `availability`: Availability state from the source.
- `stockStatus`: In-stock, out-of-stock, limited, preorder, or unknown state.
- `changeType`: Observed product state change, such as price-change, stock-change, or source-observed.
- `sourceUrl`: Source-backed product or dataset URL.
- `detectedAt`: Timestamp when the product state was detected.

- `recordId`: Stable record ID for exports, dedupe, and downstream joins.
- `title`: Human-readable record title for review and export.
- `sourceName`: Source identifier used to trace where the record came from.
- `sourceUrl`: Direct source URL for review and audit.
- `dedupeKey`: Stable key used for delta mode and duplicate suppression.
- `retrievedAt`: Timestamp showing when the actor retrieved or generated this record.
- `score`: Normalized field for filtering, routing, or downstream review.
- `scoreReasons`: Buyer-readable explanation for the score or match.
- `confidence`: Normalized field for filtering, routing, or downstream review.
- `errors`: Normalized field for filtering, routing, or downstream review.
- `runSummary`: Run-level summary for counts, filters, charges, and next actions.

### Pricing

This actor uses Apify pay-per-event pricing. Current public listing guidance: $29-$49 / 1,000 launch validation records until public data proof is complete. Charges are tied to buyer-visible value events such as `product-result`, `product-detail`, `change-alert`, `dataset-processed`, `record-saved`, `enriched-record`. Small validation runs are supported so you can inspect output before scaling a schedule.

- `product-result`: Charge after producing one catalog product result. Typical price: $0.002. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
- `product-detail`: Charge after producing one variant/detail enrichment. Typical price: $0.004. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
- `change-alert`: Charge after producing one catalog change alert. Typical price: $0.035. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
- `dataset-processed`: Base charge when Shopify WooCommerce DTC Catalog Intelligence writes a non-empty default dataset. Typical price: $0.011. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
- `first-run-cap`: Recommended first run budget cap. Typical price: $2.000. Start with the default small run, inspect the dataset, then raise maxItems or schedule recurring runs.

### API example

```bash
curl -X POST "https://api.apify.com/v2/actors/zentrafoundry~shopify-woocommerce-dtc-catalog-intelligence/runs" \
+  -H "Authorization: Bearer $APIFY_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"maxItems":10,"sourceIds":["SHOPIFY-PRODUCTS-JSON","WOOCOMMERCE-PUBLIC-CATALOG","SCHEMA-ORG-PRODUCT"],"includeSourceUrls":true,"includeMatchReasons":true,"outputMode":"buyer-ready-records"}'
````

### Demo run

### Recommended first run

```json
{
    "maxItems": 10,
    "sourceIds": [
        "SHOPIFY-PRODUCTS-JSON",
        "WOOCOMMERCE-PUBLIC-CATALOG",
        "SCHEMA-ORG-PRODUCT"
    ],
    "includeSourceUrls": true,
    "includeMatchReasons": true,
    "outputMode": "buyer-ready-records"
}
```

### Sample output

Sample status: `sample_unavailable` at https://zentra.nimblique.studio/external/actor-review/samples/shopify-woocommerce-dtc-catalog-intelligence.json. No fake sample is published; run a bounded real sample refresh before using examples in promotion.

### Recommended public tasks

```json
[
    {
        "name": "Check 10 product changes",
        "description": "Low-cost validation run for checking product, price, stock, availability, and source fields.",
        "input": {
            "maxItems": 10,
            "sourceIds": [
                "SHOPIFY-PRODUCTS-JSON",
                "WOOCOMMERCE-PUBLIC-CATALOG",
                "SCHEMA-ORG-PRODUCT"
            ],
            "includeSourceUrls": true,
            "includeMatchReasons": true,
            "outputMode": "buyer-ready-records",
            "actorSlug": "shopify-woocommerce-dtc-catalog-intelligence"
        }
    },
    {
        "name": "Daily product change check",
        "description": "Recurring batch for product price, stock, seller, rating, and catalog changes.",
        "schedule": "Daily during local business hours",
        "input": {
            "maxItems": 25,
            "sourceIds": [
                "SHOPIFY-PRODUCTS-JSON",
                "WOOCOMMERCE-PUBLIC-CATALOG",
                "SCHEMA-ORG-PRODUCT"
            ],
            "includeSourceUrls": true,
            "includeMatchReasons": true,
            "outputMode": "buyer-ready-records",
            "actorSlug": "shopify-woocommerce-dtc-catalog-intelligence"
        }
    }
]
```

### Example use cases

- Track shopify woocommerce dtc catalog intelligence product price, stock, title, seller, rating, and availability changes.
- Send product-change records into pricing, merchandising, market research, or alerting workflows.
- Compare current and previous product states with source evidence and confidence.
- Schedule recurring checks for catalog drift, stock changes, and competitor price movement.

### Trust and compliance

- Uses Shopify Products Json, Woocommerce Public Catalog, Schema Org Product.
- Keeps source URLs and source identifiers in output records for auditability.
- Does not require private credentials unless a source is explicitly configured for approved authenticated access.

### Reliability and QA

- Prefilled Apify Store QA input runs in sample mode and should finish within the automated quality window.
- Empty input is handled with deterministic sample or diagnostic output instead of a crash.
- Demo/sample runs suppress buyer-value charges while still writing representative dataset rows.
- Production runs use bounded `maxItems`, source references, warnings, and run summaries so blocked or changed targets are visible.

### Limitations

- Results depend on public-source availability, source uptime, and source update cadence.
- Public sources can revise records after publication; rerun scheduled tasks for fresh evidence.
- Scores and match reasons are decision-support signals, not legal, financial, procurement, medical, safety, or regulatory advice.
- Large production runs can cost more than the default smoke run; start small, inspect output, then scale schedules.

### Legal and responsible use

Use this Actor only for public data or data you are authorized to process. You are responsible for complying with applicable laws, marketplace terms, robots policies, privacy rules, and source-specific limits.

### Support

Open an issue on the Actor page with the run ID, input summary, expected result, and observed result. Do not include secrets, cookies, auth headers, or private account data.

### FAQ

**Can I run this without URLs?** Yes. The default `sample` mode is designed to succeed without user-supplied URLs, and URL-backed runs can use `startUrls` when needed.

**Can I schedule it?** Yes. Use `sinceLastRun`, `watchlistTerms`, and optional `webhookUrl` to turn the actor into a recurring alert or report workflow.

**How do I verify value before scaling?** Run the recommended first-run input, review the sample output fields, then increase `maxItems` or schedule recurring runs after the dataset matches your use case.

# Actor input Schema

## `buyerQuery` (type: `string`):

Buyer-safe query or scope for the records returned by this product.

## `taskIntent` (type: `string`):

Stable product-specific purpose for this saved Apify task.

## `sourceMode` (type: `string`):

Sample emits public-safe Suite Buyer Record rows. Approved live source mode keeps the same output fields and only uses owner-approved public URLs.

## `outputMode` (type: `string`):

Use sample records for Apify Store QA or buyer-ready records for approved Suite Buyer Record delivery.

## `startUrls` (type: `array`):

Public URLs to use for live Suite Buyer Record extraction after source-policy approval. Leave empty for sample mode.

## `maxItems` (type: `integer`):

Caps the number of Suite Buyer Record rows written to the dataset.

## `perSourceLimit` (type: `integer`):

Bounds each member Actor independently before suite-level deduplication.

## `maxTotalChargeUsd` (type: `number`):

Distributes this ceiling across child Actor calls. The buyer-selected parent run-level maximum separately caps suite delivery charges.

## `overallTimeoutSecs` (type: `integer`):

Stops additional source work once the bounded run deadline is reached.

## `requestTimeoutSecs` (type: `integer`):

Timeout applied independently to each approved source request.

## `maxRequestRetries` (type: `integer`):

Bounded retry count for transient source failures.

## `sinceLastRun` (type: `boolean`):

Uses stable Actor state to skip logical records delivered by earlier runs.

## `deltaMode` (type: `boolean`):

Preserves stable deduplication keys for recurring tasks and schedules.

## `memberTimeoutSecs` (type: `integer`):

Maximum time allowed for each member Actor before the suite records a source warning and continues.

## `zentraOwnerQa` (type: `boolean`):

Internal live-member validation. The Actor rejects this mode unless Apify confirms that the invoking account owns the Actor.

## Actor input object example

```json
{
  "buyerQuery": "buyer-ready records with source evidence",
  "taskIntent": "buyer-ready-product-run",
  "sourceMode": "sample",
  "outputMode": "sample-records",
  "startUrls": [],
  "maxItems": 1,
  "perSourceLimit": 5,
  "maxTotalChargeUsd": 5,
  "overallTimeoutSecs": 900,
  "requestTimeoutSecs": 30,
  "maxRequestRetries": 2,
  "sinceLastRun": false,
  "deltaMode": true,
  "memberTimeoutSecs": 300,
  "zentraOwnerQa": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "buyerQuery": "buyer-ready records with source evidence",
    "taskIntent": "buyer-ready-product-run",
    "sourceMode": "sample",
    "outputMode": "sample-records",
    "startUrls": [],
    "maxItems": 1,
    "perSourceLimit": 5,
    "maxTotalChargeUsd": 5,
    "overallTimeoutSecs": 900,
    "requestTimeoutSecs": 30,
    "maxRequestRetries": 2,
    "sinceLastRun": false,
    "deltaMode": true,
    "memberTimeoutSecs": 300,
    "zentraOwnerQa": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("zentrafoundry/shopify-woocommerce-dtc-catalog-intelligence").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 = {
    "buyerQuery": "buyer-ready records with source evidence",
    "taskIntent": "buyer-ready-product-run",
    "sourceMode": "sample",
    "outputMode": "sample-records",
    "startUrls": [],
    "maxItems": 1,
    "perSourceLimit": 5,
    "maxTotalChargeUsd": 5,
    "overallTimeoutSecs": 900,
    "requestTimeoutSecs": 30,
    "maxRequestRetries": 2,
    "sinceLastRun": False,
    "deltaMode": True,
    "memberTimeoutSecs": 300,
    "zentraOwnerQa": False,
}

# Run the Actor and wait for it to finish
run = client.actor("zentrafoundry/shopify-woocommerce-dtc-catalog-intelligence").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 '{
  "buyerQuery": "buyer-ready records with source evidence",
  "taskIntent": "buyer-ready-product-run",
  "sourceMode": "sample",
  "outputMode": "sample-records",
  "startUrls": [],
  "maxItems": 1,
  "perSourceLimit": 5,
  "maxTotalChargeUsd": 5,
  "overallTimeoutSecs": 900,
  "requestTimeoutSecs": 30,
  "maxRequestRetries": 2,
  "sinceLastRun": false,
  "deltaMode": true,
  "memberTimeoutSecs": 300,
  "zentraOwnerQa": false
}' |
apify call zentrafoundry/shopify-woocommerce-dtc-catalog-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zentrafoundry/shopify-woocommerce-dtc-catalog-intelligence",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Shopify WooCommerce DTC Catalog Intelligence",
        "description": "Extract and monitor public Shopify and WooCommerce product catalogs, variants, prices, collections, review app hints, and catalog changes.",
        "version": "1.0",
        "x-build-id": "DC7Yyv5PUsI7yardl"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zentrafoundry~shopify-woocommerce-dtc-catalog-intelligence/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zentrafoundry-shopify-woocommerce-dtc-catalog-intelligence",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/zentrafoundry~shopify-woocommerce-dtc-catalog-intelligence/runs": {
            "post": {
                "operationId": "runs-sync-zentrafoundry-shopify-woocommerce-dtc-catalog-intelligence",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/zentrafoundry~shopify-woocommerce-dtc-catalog-intelligence/run-sync": {
            "post": {
                "operationId": "run-sync-zentrafoundry-shopify-woocommerce-dtc-catalog-intelligence",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "sourceMode"
                ],
                "properties": {
                    "buyerQuery": {
                        "title": "Suite Buyer Record query",
                        "type": "string",
                        "description": "Buyer-safe query or scope for the records returned by this product.",
                        "default": "buyer-ready records with source evidence"
                    },
                    "taskIntent": {
                        "title": "Suite Buyer Record task intent",
                        "type": "string",
                        "description": "Stable product-specific purpose for this saved Apify task.",
                        "default": "buyer-ready-product-run"
                    },
                    "sourceMode": {
                        "title": "Run sample or approved live sources",
                        "enum": [
                            "sample",
                            "startUrls"
                        ],
                        "type": "string",
                        "description": "Sample emits public-safe Suite Buyer Record rows. Approved live source mode keeps the same output fields and only uses owner-approved public URLs.",
                        "default": "sample"
                    },
                    "outputMode": {
                        "title": "Suite Buyer Record output mode",
                        "enum": [
                            "sample-records",
                            "buyer-ready-records"
                        ],
                        "type": "string",
                        "description": "Use sample records for Apify Store QA or buyer-ready records for approved Suite Buyer Record delivery.",
                        "default": "sample-records"
                    },
                    "startUrls": {
                        "title": "Approved Suite Buyer Record source URLs",
                        "type": "array",
                        "description": "Public URLs to use for live Suite Buyer Record extraction after source-policy approval. Leave empty for sample mode.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "title": "URL",
                                    "type": "string",
                                    "description": "Approved public Suite Buyer Record source URL."
                                }
                            }
                        },
                        "default": []
                    },
                    "maxItems": {
                        "title": "Maximum Suite Buyer Record rows",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Caps the number of Suite Buyer Record rows written to the dataset.",
                        "default": 1
                    },
                    "perSourceLimit": {
                        "title": "Maximum rows per member source",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Bounds each member Actor independently before suite-level deduplication.",
                        "default": 5
                    },
                    "maxTotalChargeUsd": {
                        "title": "Maximum aggregate member spend (USD)",
                        "minimum": 0.01,
                        "maximum": 1000,
                        "type": "number",
                        "description": "Distributes this ceiling across child Actor calls. The buyer-selected parent run-level maximum separately caps suite delivery charges.",
                        "default": 5
                    },
                    "overallTimeoutSecs": {
                        "title": "Overall timeout seconds",
                        "minimum": 30,
                        "maximum": 3600,
                        "type": "integer",
                        "description": "Stops additional source work once the bounded run deadline is reached.",
                        "default": 900
                    },
                    "requestTimeoutSecs": {
                        "title": "Source request timeout seconds",
                        "minimum": 5,
                        "maximum": 120,
                        "type": "integer",
                        "description": "Timeout applied independently to each approved source request.",
                        "default": 30
                    },
                    "maxRequestRetries": {
                        "title": "Maximum source retries",
                        "minimum": 0,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Bounded retry count for transient source failures.",
                        "default": 2
                    },
                    "sinceLastRun": {
                        "title": "Only emit new logical records",
                        "type": "boolean",
                        "description": "Uses stable Actor state to skip logical records delivered by earlier runs.",
                        "default": false
                    },
                    "deltaMode": {
                        "title": "Delta mode",
                        "type": "boolean",
                        "description": "Preserves stable deduplication keys for recurring tasks and schedules.",
                        "default": true
                    },
                    "memberTimeoutSecs": {
                        "title": "Member timeout seconds",
                        "minimum": 30,
                        "maximum": 1800,
                        "type": "integer",
                        "description": "Maximum time allowed for each member Actor before the suite records a source warning and continues.",
                        "default": 300
                    },
                    "zentraOwnerQa": {
                        "title": "Zentra owner suite QA",
                        "type": "boolean",
                        "description": "Internal live-member validation. The Actor rejects this mode unless Apify confirms that the invoking account owns the Actor.",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
