Yahoo Shopping Search API
Under maintenancePricing
from $0.01 / 1,000 results
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.
You can access the Yahoo Shopping Search API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "A7f6WJlhzl43864kn" }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Yahoo Shopping Search API from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: