{ "openapi": "3.0.1", "info": { "title": "Showpo Scraper - Women's Fashion, Prices, Stock & Reviews", "description": "Scrape Showpo women's fashion by keyword, collection or URL. Extract product prices, colors, sizes, stock availability, descriptions, images and customer reviews. Supports search filters, sorting and scheduled monitoring to track product, price and availability changes.", "version": "0.1", "x-build-id": "EaOBjRGPFTdmsHxW3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~showpo-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-showpo-com-scraper", "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/abotapi~showpo-com-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-showpo-com-scraper", "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/abotapi~showpo-com-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-showpo-com-scraper", "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": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to discover what to scrape. Search reads keyword and collection listings. Paste URLs reads any mix of product, collection and search links.", "default": "search" }, "searchTerms": { "title": "Keywords", "type": "array", "description": "Only used when Mode = Search. One entry per keyword (for example dresses, jeans, wedding guest). Each entry becomes its own listing walk.", "items": { "type": "string" } }, "collections": { "title": "Collections", "type": "array", "description": "Only used when Mode = Search. Collection handles to walk (for example dresses, new, sale). Find handles in the store's collection URLs.", "items": { "type": "string" } }, "urls": { "title": "Showpo links (any mix)", "type": "array", "description": "Only used when Mode = Paste URLs. Paste any mix of product links (/products/), collection links (/collections/) and search links (/search?q=). Regional links (/us/, /ca/) are normalized to the AU catalog.", "default": [ "https://www.showpo.com/products/amara-maxi-dress-corset-bodice-lace-up-dress-in-blue", "https://www.showpo.com/collections/dresses", "https://www.showpo.com/search?q=dress&type=product" ], "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Read each product's page for the full description, image gallery, variants, ratings and member reviews. Off = listing rows only (cheaper, faster).", "default": true }, "maxReviews": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Cap on member reviews carried per product when details are on. Reviews bill one unit per delivered review. Set 0 to skip review reads.", "default": 20 }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "The single cap on the run: stop after collecting this many records across all searches and links. Set 0 for no cap.", "default": 20 }, "maxPages": { "title": "Max pages per source", "minimum": 0, "type": "integer", "description": "Safety bound on how many result pages to walk per keyword, collection or link. Leave 0 for no page cap.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Leave the default for the cheapest run: the catalog serves over the ordinary shared connection. If runs fail with connection errors, switch to residential.", "default": { "useApifyProxy": true } }, "resumeFromRunId": { "title": "Continue a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue that interrupted run without returning or charging for records already collected there. For recurring monitoring of the same scope, use Recurring updates below instead." }, "incrementalMode": { "title": "Recurring updates (only return what changed)", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. The first run returns all matching records as NEW. Later runs return only NEW and UPDATED records.", "default": false }, "stateKey": { "title": "State key (optional, recurring updates only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its memory stable. Leave empty to key the memory on this run setup automatically." }, "emitUnchanged": { "title": "Also return unchanged records (recurring updates only)", "type": "boolean", "description": "Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns and bills extra rows you already have.", "default": false }, "emitExpired": { "title": "Also return records that are gone (recurring updates only)", "type": "boolean", "description": "Off by default. Turn on to also return records that were present before but are no longer found, marked EXPIRED. Only produced when a run covered its whole setup.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Output field names that should NOT mark a record as UPDATED. scrapedAt is always ignored because it is stamped fresh on every fetch.", "items": { "type": "string" } }, "mcpConnectors": { "title": "MCP connectors", "type": "array", "description": "Optionally send records into the apps you already use through MCP connectors. Empty means no export.", "items": { "type": "string" } }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which record pages are created. Required to enable the Notion connector." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 0, "type": "integer", "description": "Cap on records written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }