{ "openapi": "3.0.1", "info": { "title": "Yupoo Scraper: Albums, Photo Links, Prices & New Album Monitor", "description": "Yupoo scraper for wholesale store albums: titles, categories, photo counts, prices when written in the title, and full photo links. Paste a store or agent album link, export the catalog, or schedule it and get only the albums added since the last run. Handles both Yupoo store layouts.", "version": "0.5", "x-build-id": "S69DcIbbPQJzF1Ge9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~yupoo-store-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-yupoo-store-monitor", "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/getascraper~yupoo-store-monitor/runs": { "post": { "operationId": "runs-sync-getascraper-yupoo-store-monitor", "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/getascraper~yupoo-store-monitor/run-sync": { "post": { "operationId": "run-sync-getascraper-yupoo-store-monitor", "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": { "storeUrls": { "title": "Yupoo store links", "type": "array", "description": "One or more Yupoo store links, e.g. https://storename.x.yupoo.com. Paste the store homepage, its /albums page, or any album link from the store; each is turned into that store's full album feed.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "mode": { "title": "What to output", "enum": [ "monitor", "catalog" ], "type": "string", "description": "Monitor: the first run saves a baseline, every later run outputs only albums and categories added since the last check. Catalog: every run outputs the store's albums (newest first) and remembers nothing.", "default": "monitor" }, "maxResultsPerStore": { "title": "Max albums to output per store (baseline or catalog)", "minimum": 0, "type": "integer", "description": "Caps how many albums are output per store on a baseline or catalog run, newest first. Albums beyond the cap are still remembered as seen, so they are never reported later as new. New-album alerts are not cut by this cap. Set 0 for no cap.", "default": 25 }, "includeAlbumDetails": { "title": "Add full photo links, buy links and description", "type": "boolean", "description": "Opens each output album to add every full-size photo link, the photo count found, the seller's description (and a price when the seller wrote one there), and the seller's marketplace buy links (Weidian, Taobao, 1688 and similar) that other Yupoo scrapers do not surface. Personal contact links are left out. Slower: one extra page per album.", "default": false }, "detectPhotoChanges": { "title": "Report albums whose photo count changed", "type": "boolean", "description": "Monitor mode only. Also outputs an updated_album row when a known album gains or loses photos (a restock or refresh). Needs one earlier run to learn the counts.", "default": false }, "maxAlbumsPerStore": { "title": "Max albums to scan per store, per run", "minimum": 50, "type": "integer", "description": "Safety cap on how many albums are paged through per store in one run. Raise it for very large catalogs. If you raise it later, older albums that were never scanned before can show up as new.", "default": 2000 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "How many times to retry a failed page load before giving up on that page.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Pages are fetched directly first. If Yupoo refuses a request, the Actor switches to this proxy for the rest of the run. Datacenter proxy (the default) is enough.", "default": { "useApifyProxy": true } }, "monitorScope": { "title": "Monitor scope", "type": "string", "description": "Name of the saved baseline. Leave as 'default' unless you run several independent monitors and need separate baselines.", "default": "default" }, "resetMonitoringState": { "title": "Reset monitoring baseline", "type": "boolean", "description": "Clears the saved baseline for this monitor scope before the run, so every current album is captured again as a fresh baseline. Use once after changing which stores you track.", "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 } } } } } } } } } }