{ "openapi": "3.0.1", "info": { "title": "4lapy Scraper", "description": "Scrape the Four Paws / Четыре лапы (4lapy.ru) pet catalog by category — name, price, discount, stock quantity, rating and reviews. Fast JSON API, runs on cheap datacenter proxy.", "version": "0.2", "x-build-id": "sH1AYE3fRQFdMhN9j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sashaebashu~4lapy-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sashaebashu-4lapy-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/sashaebashu~4lapy-scraper/runs": { "post": { "operationId": "runs-sync-sashaebashu-4lapy-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/sashaebashu~4lapy-scraper/run-sync": { "post": { "operationId": "run-sync-sashaebashu-4lapy-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": { "productUrls": { "title": "Product URLs (track specific products)", "type": "array", "description": "Paste 4lapy.ru product page URLs to track exactly those products — you get their current price, discount, stock and rating. Great for monitoring your own or competitors' SKUs over time. Example: https://4lapy.ru/product/royal-canin-sterilised-37-2kg-3139109-1015911/", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Search 4lapy by keyword or product name, e.g. \"корм\", \"Royal Canin Sterilised\", \"наполнитель\". Returns the top matching products (name, price, stock, rating) for each query. Use categories below if you want the full listing of a section.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs or slugs", "type": "array", "description": "4lapy.ru category pages to scrape in full. Paste full URLs like https://4lapy.ru/catalog/koshki/ or just the category slug (koshki). Top-level slugs: koshki, sobaki, gryzuny-i-khorki, ptitsy, reptilii, ryby, veterinarnaya-apteka. Subcategory URLs work too.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "popular", "price_asc", "price_desc" ], "type": "string", "description": "Product sort order used when paging a category.", "default": "popular" }, "maxPagesPerCategory": { "title": "Max pages per category", "minimum": 0, "type": "integer", "description": "How many API pages (100 products each) to fetch per category. 0 = until the category ends.", "default": 10 }, "maxItems": { "title": "Max output rows", "minimum": 0, "type": "integer", "description": "Stop after this many products in total (0 = unlimited).", "default": 0 }, "monitorMode": { "title": "Monitor mode (track changes between runs)", "type": "boolean", "description": "Compare this run to the previous one (per the same input). Each product gets changeType (new / price_up / price_down / stock_change / unchanged), previousPrice, firstSeenAt / lastConfirmedAt, and a rolling 30-day price low/high. Turns the scraper into a price & stock monitor you run on a schedule.", "default": false }, "onlyChanges": { "title": "Return only changed products", "type": "boolean", "description": "With monitor mode on, output only the products that changed since the last run (skip unchanged ones) — a clean delta for your monitor.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The 4lapy API works over Apify's datacenter proxy (cheap), which is the default. Residential is not required." } } }, "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 } } } } } } } } } }