{ "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": "pQyM1dcqlW1i5922b" }, "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", "minLength": 1, "type": "string", "description": "Enter a search term for Yahoo Shopping products (e.g., 'coffee', 'laptop', 'headphones')." }, "min_price": { "title": "Minimum Price", "pattern": "^\\d+(\\.\\d+)?$", "type": "string", "description": "Filter products by minimum price in USD. Must match the regex ^\\d+(\\.\\d+)?$ (e.g., '50' or '99.99'). Set to '0.00' to remove the lower bound.", "default": "0.00" }, "max_price": { "title": "Maximum Price", "pattern": "^\\d+(\\.\\d+)?$", "type": "string", "description": "Filter products by maximum price in USD. Must match the regex ^\\d+(\\.\\d+)?$ (e.g., '200' or '299.99'). Set to '0.00' to remove the upper bound.", "default": "0.00" }, "sort_by": { "title": "Sort By", "enum": [ "price", "relevancy", "popularity", "discountPercentage" ], "type": "string", "description": "Sort results by one of the supported fields. Combine with `order_by` for direction." }, "order_by": { "title": "Order By", "enum": [ "ASC", "DESC" ], "type": "string", "description": "Choose sort direction: 'ASC' for ascending, 'DESC' for descending." }, "category_attr_values": { "title": "Category Attributes", "type": "string", "description": "Filter by category attribute values, comma-separated (e.g., 'gender_female,age_adult')." }, "merchants": { "title": "Merchants", "type": "string", "description": "Restrict results to specific merchants. Pass a comma-separated list of merchant IDs." }, "start": { "title": "Start Position", "minimum": 0, "type": "integer", "description": "Set the offset-based pagination position. Cannot be combined with `page`. Default 0.", "default": 0 }, "limit": { "title": "Results Per Page", "minimum": 1, "maximum": 60, "type": "integer", "description": "Set the number of results per page. Maximum and default are both 60.", "default": 60 }, "page": { "title": "Page Number", "minimum": 1, "type": "integer", "description": "Set a 1-indexed page number to fetch. Cannot be combined with `start`." }, "max_pages": { "title": "Maximum Pages", "minimum": 0, "type": "integer", "description": "Cap the number of pages this run will fetch. Set to 0 for no limit. Default 1.", "default": 1 }, "output_file": { "title": "Output File", "type": "string", "description": "Save results to this filename locally. Auto-generated from the query and timestamp when omitted." } } }, "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 } } } } } } } } } }