{ "openapi": "3.0.1", "info": { "title": "Shopify App Store Audit: Dead Privacy Policy Links", "description": "Shopify requires every app to publish a privacy policy and never rechecks the link. This audits the links a listing declares: policies that 404, policies that redirect to a homepage, domains nobody has registered - anyone can publish there - and dead developer and documentation links.", "version": "0.1", "x-build-id": "sIjYq5TUj7746XsnT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aiqlabs~shopify-app-audit/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aiqlabs-shopify-app-audit", "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/aiqlabs~shopify-app-audit/runs": { "post": { "operationId": "runs-sync-aiqlabs-shopify-app-audit", "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/aiqlabs~shopify-app-audit/run-sync": { "post": { "operationId": "run-sync-aiqlabs-shopify-app-audit", "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": { "apps": { "title": "App handles or listing URLs", "type": "array", "description": "The apps to audit. Either the handle from the listing URL (klaviyo-email-marketing) or the full URL (https://apps.shopify.com/klaviyo-email-marketing). Store search URLs are refused: apps.shopify.com/robots.txt disallows any URL carrying \"q=\", so this Actor never fetches one.", "items": { "type": "string" } }, "categories": { "title": "Category slugs (optional)", "type": "array", "description": "Discover apps from category pages instead of listing them by hand, e.g. store-design-site-optimization-seo. Take the slug from a category URL. Category pages are what robots.txt permits; the store search is not.", "items": { "type": "string" } }, "pagesPerCategory": { "title": "Pages to read per category", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages of each category to walk. One page is about 25 apps. Stops early when a page adds nothing new.", "default": 1 }, "checkDeveloperWebsite": { "title": "Check the developer website", "type": "boolean", "description": "Fetch the developer's own website link and report where it lands.", "default": true }, "checkResourceLinks": { "title": "Check FAQ, tutorial and documentation links", "type": "boolean", "description": "Also check the supporting links a listing declares. These are reported at low severity: unlike the privacy policy, Shopify does not require them.", "default": true }, "checkDomainRegistration": { "title": "Read the domain registration for failed links", "type": "boolean", "description": "For links that do not resolve, ask RDAP whether the domain is registered at all. This is what separates \"the page is gone\" from \"anyone can take this address\". Only failed links are looked up.", "default": true }, "onlyIssues": { "title": "Only output apps with findings", "type": "boolean", "description": "Leave the clean listings out of the dataset. The counts in SUMMARY still cover every app checked.", "default": false }, "maxApps": { "title": "Maximum apps to audit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "A ceiling on the run, applied after the input is resolved. Anything dropped is named in SUMMARY.notes.", "default": 200 }, "maxConcurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many requests are in flight at once. Kept low on purpose: these are ordinary page loads on someone else's server.", "default": 4 }, "requestDelayMs": { "title": "Pause between listing requests (ms)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "A fixed pause after each listing page, so a large run does not arrive as a burst.", "default": 600 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 180, "type": "integer", "description": "How long any single request may take before it is recorded as unchecked.", "default": 30 } } }, "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 } } } } } } } } } }