{ "openapi": "3.0.1", "info": { "title": "Amazon US Apparel PPC Decision Auditor", "description": "Your ads are spending. What should you change—and what should you leave alone? Turn normalized Amazon US apparel PPC data into a reviewable decision list with reasons, risks, and evidence gaps. No Amazon login or automatic ad changes.", "version": "0.5", "x-build-id": "pdwlbEQMLQv1XCfS0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ysoserious_h~amazon-us-apparel-ppc-decision-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ysoserious_h-amazon-us-apparel-ppc-decision-auditor", "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/ysoserious_h~amazon-us-apparel-ppc-decision-auditor/runs": { "post": { "operationId": "runs-sync-ysoserious_h-amazon-us-apparel-ppc-decision-auditor", "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/ysoserious_h~amazon-us-apparel-ppc-decision-auditor/run-sync": { "post": { "operationId": "run-sync-ysoserious_h-amazon-us-apparel-ppc-decision-auditor", "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", "properties": { "auditInput": { "title": "Normalized audit JSON - SYNTHETIC DEMO prefilled", "type": "object", "description": "This prefilled object is a constructed synthetic fixture, not seller data or a customer outcome. For a real JSON audit, replace it entirely with your audit, report, product, policy and rows. For CSV, REMOVE this field entirely before entering CSV fields; empty object or null is not removal. The demo uses normal Actor pricing. No runtime sample fallback or filling missing customer fields. The same synthetic demo is also available in README." }, "csvText": { "title": "CSV rows (CSV mode only)", "type": "string", "description": "Paste UTF-8 CSV text, not a URL. At most 2 MiB and 1,000 rows; preserve source IDs. Leave auditInput unset." }, "csvContext": { "title": "Seller context (required for CSV)", "type": "object", "description": "Provide exactly audit, report, product and policy objects. At most64 KiB. No inferred dates, economics or thresholds; missing information remains unknown or is rejected." }, "csvMapping": { "title": "CSV header mapping (optional)", "type": "object", "description": "Explicit normalized field -> exact trimmed source header. Omit only when headers already use normalized field names." }, "csvDelimiter": { "title": "CSV delimiter (optional; comma when omitted)", "enum": [ "comma", "tab", "semicolon" ], "type": "string", "description": "Choose the actual delimiter; it is never guessed." }, "discardUnmapped": { "title": "Explicitly discard unmapped CSV columns", "type": "boolean", "description": "For CSV, omission is false; enable only to deliberately omit unmapped columns. Credential columns still cause rejection. With auditInput only, the real JSON boolean false is accepted as an inert form addition; true, null, strings, numeric zero and any other extra root key are rejected." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }