Yahoo! Shopping API

/search?engine=yahoo_shopping API endpoint allows you to scrape the results from Yahoo! Shopping search engine via our SerpApi service.

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

Description A user may query the following: https://serpapi.abcproxy.com/search?engine=yahoo_shopping utilizing a GET request. Head to the playground for a live and interactive demo.

---

Request

HTTP Request

---

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=yahoo_shopping" \
  -d "p=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "yahoo_shopping",
    "p": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "yahoo_shopping",
  p: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=yahoo_shopping&p=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'yahoo_shopping',
        'p' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "yahoo_shopping")
    q.Add("p", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "yahoo_shopping";
        query["p"] = "Coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=yahoo_shopping" +
            "&p=Coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

Parameters

Search Query

Name	Type	Required	Description	Example
p	string	Yes	Parameter defines the search query. You can use anything that you would use in a regular Yahoo! shopping search.	coffee

Advanced Yahoo Shopping Parameters

Name	Type	Required	Description	Example
min_price	string	No	Lower bound of price range query.	50
max_price	string	No	Upper bound of price range query.	100
sort_by	string	No	Parameter is used for sorting and refining results. Available options: price - the costliest items first. relevancy - the most relevant items first. popularity - the most popular items first. discountPercentage - the highest discounted items (by percentage) first.	-
order_by	string	No	Parameter used to sort the query results in a top to bottom style or vice-versa.	ASC and DESC.
category_attr_values	string	No	Gender and Age Range filters on Yahoo! Shopping Search separated by comma (,).	gender_female,age_adult
merchants	string	No	Merchants ID separated by comma (,). Merchant IDs can be obtained from filters.stores in API response.	3719d8d4-5edd-4817-998a-91f3229e7323

Pagination

Name	Type	Required	Description	Example
start	int	No	Parameter defines the result offset. It skips the given number of results. It's used for pagination.	1
limit	int	No	The page parameter does the start parameter math for you! Just define the page number you want.	10
page	int	No	The page parameter does the start parameter math for you! Just define the page number you want.	1

Serpapi Parameters

Name	Type	Required	Description	Example
engine	string	Yes	Set parameter to yahoo_shopping to use the Yahoo! shopping API engine.	yahoo_shopping
no_c1ache	boolean	No	Parameter will force SerpApi to fetch the Google Patents results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month.	true or false
api_key	string	Yes	Parameter defines the SerpApi private key to use.	YOUR_API_KEY

---

Response

Success 200

Response Body

{
  "code": 200,
  "search_parameters": {
    "engine": "yahoo_shopping",
    "no_cache": true,
    "api_key": "YOUR_API_KEY",
    "p": "Coffee"
  },
  "search_metadata": {
    "json_endpoint": "https://webserp.abcproxy.com/files/71b67ce45c847b94/ffaefbb2-c779-4cb0-9c05-76566c570f08.json",
    "created_at": "2025-04-09 14:13:04",
    "yahoo_url": "https://shopping.yahoo.com/search?p=Coffee",
    "raw_html_file": "https://webserp.abcproxy.com/files/71b67ce45c847b94/ffaefbb2-c779-4cb0-9c05-76566c570f08.html",
    "xray_html_file": "https://webserp.abcproxy.com/files/71b67ce45c847b94/ffaefbb2-c779-4cb0-9c05-76566c570f08.xray",
    "total_time_taken": "8.8580",
    "id": "ffaefbb2-c779-4cb0-9c05-76566c570f08"
  },
  "shopping_results": [
    {
      "price": "$31.90",
      "position": 1,
      "title": "Coffee Roasters of Jamaica - 100% Jamaica Blue Mountain Ground Coffee (8oz)",
      "link": "https://shopping.yahoo.com/product/00619752100809/Coffee-Roasters-of-Jamaica---100--Jamaica-Blue-Mountain-Ground-Coffee--8oz-?pid=amazon_B002OGKT7C",
      "thumbnail": "https://s.yimg.com/lo/api/res/1.2/NrVfMOuFFB4PIEUgiROmbg--/YXBwaWQ9ZWNfaG9yaXpvbnRhbDtoPTQwMDtzcz0xO3c9NDAw/https://m.media-amazon.com/images/I/51gvFTvR-3L._SL500_.jpg",
      "product_id": "00619752100809",
      "seller": "Amazon"
    },
    ...
  ],
  "filters": [
    {
      "key": "Categories",
      "value": [
        {
          "id": "436",
          "name": "Furniture"
        },
        ...
      ]
    },
    ...
  ],
  ...
}

Response Fields

Field	Type	Description
search_parameters	object	Contains query parameters and search context
search_metadata	object	Contains timing and status information
shopping_results	object[]	List of shopping product results
filters	object[]	List of available search filters

---

Error Responses

Common Errors

HTTP Status	Error Code	Description
200	400	API Key can not be empty
200	401	Param error
200	402	API Key error
200	403	Insufficient Balance
200	404	Deduction failed
200	405	Failed to record usage count
200	406	Unsupported engine
200	407	Network error
200	408	File not found
200	409	Limit param error
200	410	Build url error
200	411	Failed to QueryRecentRecord
200	412	Failed to find json
200	413	Get html error
200	414	HTML is empty
200	429	Too many request

Error Example

{
  "code": 400,
  "message": "API Key can not be empty"
}

---