Yahoo 購物 API

/search?engine=yahoo_shopping API 端點允許您透過 SerpApi 服務獲取 Yahoo! 購物搜尋結果。

API 詳情

端點GET https://serpapi.abcproxy.com/search

描述

使用者可透過 GET 請求查詢：https://serpapi.abcproxy.com/search?engine=yahoo_shopping。前往工作臺查看互動式即時演示。

---

請求

HTTP 請求

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);
    }
}

參數

搜尋查詢

名稱	類型	必填	描述	範例
p	字符串	是	定義搜尋查詢	coffee

進階購物參數

名稱	類型	必填	描述	範例
min_price	字符串	否	價格範圍查詢下限	50
max_price	字符串	否	價格範圍查詢上限	100
sort_by	字符串	否	結果排序方式： price - 價格最高優先 relevancy - 最相關優先 popularity - 最熱門優先 discountPercentage - 折扣比例最高優先	-
order_by	字符串	否	排序方向	ASC (升序) 或 DESC (降序)
category_attr_values	字符串	否	性別與年齡範圍篩選（逗號分隔）	gender_female,age_adult
merchants	字符串	否	商家ID列表（逗號分隔）	3719d8d4-5edd-4817-998a-91f3229e7323

分頁

名稱	類型	必填	描述	範例
start	整數型	否	結果偏移量	1
limit	整數型	否	每頁結果數量	10
page	整數型	否	直接指定頁碼（自動計算偏移）	1

Serpapi 參數

名稱	類型	必填	描述	範例
engine	字符串	是	需設為 yahoo_shopping 使用購物API	yahoo_shopping
no_cache	布爾值	否	強制重新抓取結果（即使有緩存）	true 或 false
api_key	字符串	是	SerpApi 私鑰	YOUR_API_KEY

---

響應

成功 200

響應主體

{
  "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"
        },
        ...
      ]
    },
    ...
  ],
  ...
}

響應欄位

欄位	類型	描述
search_parameters	對象	包含查詢參數及搜尋上下文
search_metadata	對象	包含時間和狀態資訊
shopping_results	對象數組	商品搜尋結果列表
filters	對象數組	可用搜尋篩選器列表

---

錯誤響應

常見錯誤

HTTP 狀態碼	錯誤代碼	描述
200	400	API 金鑰不可為空
200	401	參數錯誤
200	402	API 金鑰錯誤
200	403	餘額不足
200	404	扣費失敗
200	405	用量記錄失敗
200	406	不支援的引擎
200	407	網路錯誤
200	408	檔案不存在
200	429	請求過於頻繁
200	409	限制參數錯誤
200	410	URL 建構錯誤
200	411	查詢記錄失敗
200	412	找不到 JSON
200	413	獲取 HTML 錯誤
200	414	HTML 內容為空

錯誤範例

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

---