{ "openapi": "3.0.1", "info": { "title": "1688 Profit Margin Calculator and Cost Auditor", "description": "Check 1688 wholesale profitability before ordering. Compare tier pricing, MOQ overbuy, freight, import duty and selling fees using your own quotes and exchange rate. No live scraping, exchange API or supplier verification.", "version": "0.0", "x-build-id": "hGpAo6H1FjXNpgfPc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quanmatrix~1688-tier-price-margin-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quanmatrix-1688-tier-price-margin-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/quanmatrix~1688-tier-price-margin-auditor/runs": { "post": { "operationId": "runs-sync-quanmatrix-1688-tier-price-margin-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/quanmatrix~1688-tier-price-margin-auditor/run-sync": { "post": { "operationId": "run-sync-quanmatrix-1688-tier-price-margin-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": { "currentItems": { "title": "Imported 1688 wholesale records", "maxItems": 1000, "type": "array", "description": "CUSTOMER-SUPPLIED 1688 offers. Prefill is entirely fictional; replace it before commercial decisions. Each row contains offerId, sellerLoginId, priceCny, minOrderQuantity and optional priceTiers.", "items": { "type": "object" } }, "currentDatasetId": { "title": "Current Apify Dataset ID", "type": "string", "description": "Read an existing authorized Apify dataset instead of inline offers; no live 1688 scraping." }, "desiredQuantity": { "title": "Units you plan to sell", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "User estimate only, not externally verified.", "default": 80 }, "resalePriceUsd": { "title": "Resale price per unit USD", "minimum": 1, "maximum": 1000000, "type": "number", "description": "User estimate only, not externally verified.", "default": 9.5 }, "exchangeRateUsdPerCny": { "title": "Your USD per 1 CNY rate", "minimum": 0.000001, "maximum": 1000000, "type": "number", "description": "Your own assumption; 0.14 in demo is NOT a verified exchange rate.", "default": 0.14 }, "shippingUsd": { "title": "Fallback freight USD per supplier", "minimum": 0, "maximum": 1000000, "type": "number", "description": "User estimate only, not externally verified.", "default": 0 }, "importDutyPct": { "title": "Estimated import duty %", "minimum": 0, "maximum": 100, "type": "number", "description": "User estimate only, not externally verified.", "default": 8 }, "platformFeePct": { "title": "Marketplace fees on revenue %", "minimum": 0, "maximum": 100, "type": "number", "description": "User estimate only, not externally verified.", "default": 12 }, "targetMarginPct": { "title": "Minimum target net margin %", "minimum": 0, "maximum": 100, "type": "number", "description": "User estimate only, not externally verified.", "default": 25 }, "previousItems": { "title": "Previous 1688 offers (optional)", "type": "array", "description": "Earlier customer-supplied snapshot for comparing wholesale price changes. Demo prefill is fictional.", "items": { "type": "object" } }, "previousDatasetId": { "title": "Previous Apify Dataset ID", "type": "string", "description": "Optional earlier Apify dataset for price changes. Inline previousItems have priority." }, "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of rows processed from an existing Apify dataset or inline offers.", "default": 100 }, "previousAnalysis": { "title": "Previous Gen2 analysis", "type": "object", "description": "Optional prior Gen2 output used to calculate decision-metric deltas and regression." }, "valuePerImpactUnitUsd": { "title": "Value per impact unit (USD)", "minimum": 0, "type": "number", "description": "Optional user-supplied economic value per impact unit. Leave empty to avoid monetary estimation." }, "monthlyRuns": { "title": "Monthly run volume", "minimum": 1, "type": "integer", "description": "Optional expected monthly run count used only with valuePerImpactUnitUsd for economic impact estimation.", "default": 1 }, "mcpConnectors": { "title": "MCP output connectors", "type": "array", "description": "Optional MCP connectors authorized in your Apify account. Use them to send or write this Actor result to tools such as Slack, Notion, GitHub, Sentry, Supabase, or another compatible MCP service." }, "mcpActionPreset": { "title": "MCP action preset", "enum": [ "AUTO_SAFE_WRITE", "SLACK_MESSAGE", "GITHUB_ISSUE", "NOTION_PAGE", "DATABASE_WRITE", "CUSTOM" ], "type": "string", "description": "Choose a safe action pattern. AUTO_SAFE_WRITE discovers a compatible non-destructive write tool automatically; use a specific preset for Slack, GitHub, Notion, or database delivery.", "default": "AUTO_SAFE_WRITE" }, "mcpToolName": { "title": "MCP tool name", "type": "string", "description": "Optional exact MCP tool name. Leave blank to let the selected MCP action preset discover a compatible tool automatically.", "default": "" }, "mcpToolArguments": { "title": "MCP tool arguments", "type": "object", "description": "JSON object passed to the selected MCP tool. String values may use {{actor_title}}, {{result_summary}}, or {{result_json}} placeholders.", "default": {} }, "mcpFailOnError": { "title": "Fail run if MCP delivery fails", "type": "boolean", "description": "When enabled, an MCP delivery error fails the Actor run. Disabled by default so data extraction and intelligence results remain available even if the external destination is unavailable.", "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 }, "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 } } } } } } } } } }