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"
參數
搜尋查詢
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
對象數組
推薦搜尋查詢列表
錯誤響應
常見錯誤
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"
}