{ "openapi": "3.0.1", "info": { "title": "Rugs.com Area Rug Catalog & Price Scraper", "description": "Collect public Rugs.com rugs from the full catalog or submitted product, collection, and category pages. Save one row per rug with source-backed size and SKU variants, current prices, availability, and product details. Filter and sort by price, rating, sale, stock, color, material, or review count.", "version": "0.0", "x-build-id": "LfbX0elPiaKTKtPs7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~rugs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-rugs", "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/maximedupre~rugs/runs": { "post": { "operationId": "runs-sync-maximedupre-rugs", "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/maximedupre~rugs/run-sync": { "post": { "operationId": "run-sync-maximedupre-rugs", "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", "required": [ "discoveryMethod" ], "properties": { "discoveryMethod": { "title": "Find rugs by", "enum": [ "full_catalog", "product_or_collection_pages" ], "type": "string", "description": "Choose one way to find rug SKU records. Full catalog scans the public catalog. The Product or collection pages option uses the URLs you enter." }, "startUrls": { "title": "Rugs.com pages", "minItems": 1, "type": "array", "description": "Add one or more public Rugs.com product, collection, or category page URLs. Use product pages for specific rugs and collection or category pages for broader results. This field is required when Find rugs by is Product or collection pages.", "items": { "type": "object", "properties": { "url": { "title": "Page URL", "description": "A public Rugs.com product, collection, or category page URL.", "type": "string", "pattern": "^https?://(?:www\\.)?rugs\\.com(?:/|$)" } }, "required": [ "url" ] } }, "minimumPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "number", "description": "Only include rugs with a current variant price at or above this USD amount. Leave blank for no minimum." }, "maximumPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "number", "description": "Only include rugs with a current variant price at or below this USD amount. Leave blank for no maximum." }, "minimumRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only include rugs with a customer rating at or above this value from 0 to 5. Leave blank for no rating filter." }, "saleStatus": { "title": "Sale status", "enum": [ "on_sale", "not_on_sale" ], "type": "string", "description": "Choose whether to include rugs marked on sale or rugs not marked on sale. Leave blank to include both." }, "stockStatus": { "title": "Stock status", "enum": [ "in_stock", "out_of_stock" ], "type": "string", "description": "Choose whether to include rugs marked in stock or rugs marked out of stock. Leave blank to include both." }, "colors": { "title": "Colors", "minItems": 1, "type": "array", "description": "Enter one or more color names. A rug is included when its source-backed color data matches any entered value. Leave blank for all colors.", "items": { "type": "string" } }, "materials": { "title": "Materials", "minItems": 1, "type": "array", "description": "Enter one or more material names. A rug is included when its source-backed material data matches any entered value. Leave blank for all materials.", "items": { "type": "string" } }, "sortBy": { "title": "Sort results by", "enum": [ "price_asc", "price_desc", "rating_asc", "rating_desc", "review_count_asc", "review_count_desc" ], "type": "string", "description": "Choose an order by current price, customer rating, or review count. Leave blank to keep the source order." }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Optional stop for a run that could return many rug records. Enter a positive integer to stop after that many saved rows. Leave blank to return all available results until the source is exhausted." } } }, "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 } } } } } } } } } }