{ "openapi": "3.0.1", "info": { "title": "Yahoo Shopping Search Scraper", "description": "Extract product listings, prices, seller info, and descriptions from Yahoo Shopping. Supports price filtering, sorting, category filtering, merchant filtering, and pagination. Returns structured JSON data for market research and price monitoring.", "version": "0.0", "x-build-id": "NzrTsx1ed2RZDcTLX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~Yahoo-Shopping-Search-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-Yahoo-Shopping-Search-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/johnvc~Yahoo-Shopping-Search-Scraper/runs": { "post": { "operationId": "runs-sync-johnvc-Yahoo-Shopping-Search-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/johnvc~Yahoo-Shopping-Search-Scraper/run-sync": { "post": { "operationId": "run-sync-johnvc-Yahoo-Shopping-Search-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", "required": [ "query" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "Search query string (e.g., 'coffee', 'laptop', 'headphones'). Required. " }, "min_price": { "title": "Minimum Price", "pattern": "^\\d+(\\.\\d+)?$", "type": "string", "description": "Minimum price filter in USD. Optional. Must be a valid number (e.g., '50' or '99.99'). Default: '0.00' (no minimum).", "default": "0.00" }, "max_price": { "title": "Maximum Price", "pattern": "^\\d+(\\.\\d+)?$", "type": "string", "description": "Maximum price filter in USD. Optional. Must be a valid number (e.g., '200' or '299.99'). Default: '0.00' (no maximum).", "default": "0.00" }, "sort_by": { "title": "Sort By", "enum": [ "price", "relevancy", "popularity", "discountPercentage" ], "type": "string", "description": "Sort results by: 'price', 'relevancy', 'popularity', or 'discountPercentage'. Optional." }, "order_by": { "title": "Order By", "enum": [ "ASC", "DESC" ], "type": "string", "description": "Sort order: 'ASC' for ascending, 'DESC' for descending. Optional." }, "category_attr_values": { "title": "Category Attributes", "type": "string", "description": "Category filter values (comma-separated, e.g., 'gender_female,age_adult'). Optional." }, "merchants": { "title": "Merchants", "type": "string", "description": "Filter by specific merchants (comma-separated merchant IDs). Optional." }, "start": { "title": "Start Position", "minimum": 0, "type": "integer", "description": "Starting position for pagination (default: 0). Optional.", "default": 0 }, "limit": { "title": "Results Per Page", "minimum": 1, "maximum": 60, "type": "integer", "description": "Number of results per page (default: 60, maximum: 60). Optional.", "default": 60 }, "page": { "title": "Page Number", "minimum": 1, "type": "integer", "description": "Specific page number to fetch (1-indexed). Optional. If not provided, pagination starts from 'start' position." }, "max_pages": { "title": "Maximum Pages", "minimum": 0, "type": "integer", "description": "Maximum number of pages to fetch (0 = no limit, default: 1).", "default": 1 }, "output_file": { "title": "Output File", "type": "string", "description": "Optional filename to save results. If not provided, will auto-generate based on query and timestamp." } } }, "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 } } } } } } } } } }