Yahoo 圖片 API

我們的 Yahoo! 圖片 API 允許您從 Yahoo! 圖片獲取搜尋結果。API 透過以下端點存取：/search?engine=yahoo_images。

API 詳情

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

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

請求

HTTP 請求

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

import requests

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

const axios = require('axios');

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

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

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

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

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_images")
    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))
}

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_images";
        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());
    }
}

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_images" +
            "&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

字符串

是

定義搜尋查詢，可用於常規 Yahoo! 搜尋

coffee

本地化

名稱

類型

必填

描述

範例

yahoo_domain

字符串

否

指定 Yahoo! 域名

fr.search.yahoo.com

進階圖片參數

名稱

類型

必填

描述

範例

imgsz

字符串

否

按圖片尺寸篩選： small - 小尺寸 medium - 中等 large - 大尺寸 wallpaper - 超大尺寸

large

imgc

字符串

否

按顏色篩選： color - 彩色 bw - 黑白 red - 紅色 orange - 橙色 yellow - 黃色 green - 綠色 teal - 青色 blue - 藍色 purple - 紫色 pink - 粉色 brown - 棕色 black - 黑色 gray - 灰色 white - 白色

color

imgty

字符串

否

按類型篩選： photo - 照片 clipart - 剪貼畫 linedrawing - 線條圖 gif - 動畫 GIF transparent - 透明背景

photo

imga

字符串

否

按長寬比篩選： square - 正方形 wide - 寬屏 tall - 豎屏

wide

imgf

字符串

否

按人像篩選： face - 僅面部 portrait - 頭部和肩部 nonportrait - 無人像

face

imgt

字符串

否

按時間篩選： day - 過去 24 小時 week - 過去一週 month - 過去一月 year - 過去一年

week

imgl

字符串

否

按使用權限篩選： cc - 所有創用CC pd - 公有領域 fsu - 可分享使用 fsuc - 可商業分享使用 fmsu - 可修改分享使用 fmsuc - 可商業修改分享使用

cc

分頁

名稱

類型

必填

描述

範例

b

整數型

是

定義結果偏移量

1

Serpapi 參數

名稱

類型

必填

描述

範例

engine

字符串

是

需設為 yahoo_images 使用圖片 API

yahoo_images

no_cache

布爾值

否

強制重新抓取結果（即使有緩存）

true 或 false

api_key

字符串

是

SerpApi 私鑰

YOUR_API_KEY

響應

成功 200

響應主體

{
  "code": 200,
  "search_parameters": {
    "engine": "yahoo_images",
    "no_cache": true,
    "api_key": "YOUR_API_KEY",
    "p": "Coffee"
  },
  "search_metadata": {
    "id": "d76f0cf8-c810-42b4-9bde-6508b99ce625",
    "json_endpoint": "https://webserp.abcproxy.com/files/ef62cad087b1ee4c/d76f0cf8-c810-42b4-9bde-6508b99ce625.json",
    "created_at": "2025-04-09 14:02:33",
    "yahoo_url": "https://images.search.yahoo.com/search/images?p=Coffee",
    "raw_html_file": "https://webserp.abcproxy.com/files/ef62cad087b1ee4c/d76f0cf8-c810-42b4-9bde-6508b99ce625.html",
    "xray_html_file": "https://webserp.abcproxy.com/files/ef62cad087b1ee4c/d76f0cf8-c810-42b4-9bde-6508b99ce625.xray",
    "total_time_taken": "7.1118"
  },
  "images_results": [
    {
      "original": "3.bp.blogspot.com/-U2uqPh7hw0U/UHNEoLahrPI/AAAAAAAAAv8/buuzujhKZkY/s1600/coffee.jpg",
      "source": "http://bellevueclub.blogspot.com/2012/10/coffees-health-benefitsand-how-to-taste.html",
      "size": "191KB",
      "title": "Bellevue Club: Coffee's Health…",
      "position": 1,
      "thumbnail": "https://tse3.mm.bing.net/th?id=OIP.Re7WHLgpMU2E8obQUJb-TAAAAA&pid=Api&P=0&h=220",
      "link": "https://images.search.yahoo.com/images/view;_ylt=Awrihisom_Nn5mEMhUeJzbkF;_ylu=c2VjA3NyBHNsawNpbWcEb2lkA2EwY2NiMDE3MzQzYWZiZWI4MjRhZGQyY2YwOGU0YmQ0BGdwb3MDMQRpdANiaW5n?back=https%3A%2F%2Fimages.search.yahoo.com%2Fsearch%2Fimages%3Fp%3DCoffee%26tab%3Dorganic%26ri%3D1&w=474&h=710&imgurl=3.bp.blogspot.com%2F-U2uqPh7hw0U%2FUHNEoLahrPI%2FAAAAAAAAAv8%2FbuuzujhKZkY%2Fs1600%2Fcoffee.jpg&rurl=http%3A%2F%2Fbellevueclub.blogspot.com%2F2012%2F10%2Fcoffees-health-benefitsand-how-to-taste.html&size=191KB&p=Coffee&oid=a0ccb017343afbeb824add2cf08e4bd4&fr2=&fr=&tt=Bellevue+Club%3A+Coffee%26%2339%3Bs+Health+Benefits...and+How+to+Taste+It%21&b=0&ni=21&no=1&ts=&tab=organic&sigr=rnAAVwMciMuZ&sigb=33bPYwNEOiSX&sigi=AqnI4YQ6m2u2&sigt=SJOEbT5vhcZz&.crumb=czh6bch2gIv&"
    },
    ...
  ],
  "shopping_results": [
    {
      "thumbnail": "https://sp.yimg.com/ib/th?id=OPHS.LWTQIvvNk8YUoA474C474&o=5&pid=21.1&w=174&h=174",
      "seller": "Nespresso US",
      "price": {
        "value": "$13.00",
        "extracted_value": 13
      },
      "position": 1,
      "title": "Nespresso - Melozio - Sleeve Of 10 - Vertuo Coffee Capsules",
      "link": "https://r.search.yahoo.com/rdclks/dWU9NThlNG9rOWp2NzZwOCZ1dD0xNzQ0MDE4MjE2ODYxJnVvPTgyMzk1MDI5MDM4MTg4MSZsdD0yJnM9MSZlcz00SFo0OF9oUGZIS193RVBCOUZZbmN1Sjl6SVpQU0VoQm5mZVRvRHhxdk5SOXNhQkxxbXJXcktXUjQ5MWpCVEFzaEY5a1BzYXBsVjQwUzhJLQ--/RV=2/RE=1746610217/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de8NL273pcG6mw9PPhHlKT01zVUCUz4SgCTJKhZgqtSrfsnF8oGhhpChYi4_7897Lj5cL3tSexSMwyfyrPIYpGhvFTGYTgYjmKO51Z6fj1XbL5CifmzhR3gyAD4Vd9-Id-Ax3Ojtce8Y14wFQ02DK4peN1T_OmNl7-VK-5UN9blQ5ihXL7coZMjsk-GMVx9AZnrfrJVOQ%26u%3daHR0cHMlM2ElMmYlMmZhZC5kb3VibGVjbGljay5uZXQlMmZzZWFyY2hhZHMlMmZsaW5rJTJmY2xpY2slM2ZsaWQlM2Q5MjcwMDA4MDYzMzA1OTM2NyUyNmRzX3Nfa3dnaWQlM2Q1ODcwMDAwODcxMDUyNzAzNCUyNmRzX3NfaW52ZW50b3J5X2ZlZWRfaWQlM2Q5NzcwMDAwMDAxMDgyNjE2MSUyNmRzX2FfY2lkJTNkNDA2OTc3Nzg0JTI2ZHNfYV9jYWlkJTNkMjA3OTEyMDg1MjklMjZkc19hX2FnaWQlM2QxNjQ2NTgzOTQ3MjklMjZkc19hX2xpZCUzZHBsYS0yMzM5ODU5MDg5Njc5JTI2JTI2ZHNfZV9hZGlkJTNkODIzOTUwMjkwMzgxODglMjZkc19lX3RhcmdldF9pZCUzZHBsYS00NTg1OTk0Mjg2NTMwNzM3JTI2ZHNfZV9wcm9kdWN0X2dyb3VwX2lkJTNkNDU4NTk5NDI4NjUzMDczNyUyNmRzX2VfcHJvZHVjdF9pZCUzZFVTXzcwMzkuMTAlMjZkc19lX3Byb2R1Y3RfY291bnRyeSUzZFVTJTI2ZHNfZV9wcm9kdWN0X2xhbmd1YWdlJTNkZW4lMjZkc19lX3Byb2R1Y3RfY2hhbm5lbCUzZE9ubGluZSUyNmRzX2VfbmV0d29yayUzZG8lMjZkc191cmxfdiUzZDIlMjZkc19kZXN0X3VybCUzZGh0dHBzJTNhJTJmJTJmd3d3Lm5lc3ByZXNzby5jb20lMmZ1cyUyZmVuJTJmb3JkZXIlMmZjYXBzdWxlcyUyZnZlcnR1byUyZm1lbG96aW8tdmVydHVvLWNvZmZlZS1wb2RzJTNmZ2NsaWQlM2RjYzNlYzk3NjJmNTkxMGQ5NGE0M2FlODViNDcwYWQ0MSUyNmdjbHNyYyUzZDNwLmRzJTI2bXNjbGtpZCUzZGNjM2VjOTc2MmY1OTEwZDk0YTQzYWU4NWI0NzBhZDQx%26rlid%3dcc3ec9762f5910d94a43ae85b470ad41/RK=2/RS=Tbehb3lscjq8kQknOUN6BjlxRUY-;_ylt=Awrihisom_Nn5mEM0kaJzbkF;_ylu=cG9zAzEEc2VjA292LXRvcC1wbGE-;_ylc=cnQDMA--?p=Coffee"
    },
    ...
  ],
  ...
}

響應欄位

欄位

類型

描述

search_parameters

對象

包含查詢參數及搜尋上下文

search_metadata

對象

包含時間和狀態資訊

images_results

對象數組

圖片搜尋結果列表

shopping_results

對象數組

購物相關結果列表

related_searches

對象數組

相關搜尋建議列表

suggested_searches

對象數組

推薦搜尋查詢列表

錯誤響應

常見錯誤

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"
}

上一页Yahoo 搜尋 API 下一页Yahoo 購物 API