Yahoo Images
Search Yahoo Images.
GET/api/v1/yahoo/images
Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.
Parameters
Search
Query, localization and pagination.
| Parameter | Type | Description |
|---|---|---|
prequired | string | Text or search operators to send to Yahoo.Up to 2,000 characters. |
yahoo_domain | string | Yahoo regional search host, for example fr.search.yahoo.com. A regional prefix such as fr is also accepted.Default: search.yahoo.com. |
b | integer | One-based starting result. Web pages usually advance by 10; image pages usually advance by 60.Default: 1.Range: 1 to 10001. |
device | "desktop" | "tablet" | "mobile" | Device profile used for the Yahoo result page.Default: desktop. |
Filters
Narrow the Yahoo result set.
| Parameter | Type | Description |
|---|---|---|
imgsz | "small" | "medium" | "large" | "wallpaper" | Image size category; wallpaper selects extra-large images. |
imgc | "color" | "bw" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "purple" | "pink" | "brown" | "black" | "gray" | "white" | Select color images, monochrome images (bw), or a dominant color. |
imgty | "photo" | "clipart" | "linedrawing" | "gif" | "transparent" | Image style or format to include. |
imga | "square" | "wide" | "tall" | Image shape: square, landscape (wide), or portrait (tall). |
imgf | "face" | "portrait" | "nonportrait" | People filter: faces, head-and-shoulders portraits, or images without people. |
imgt | "day" | "week" | "month" | "year" | Limit images to a recent day, week, month, or year. |
imgl | "cc" | "pd" | "fsu" | "fsuc" | "fmsu" | "fmsuc" | Usage-rights category: Creative Commons (cc), public domain (pd), sharing (fsu), commercial sharing (fsuc), modification (fmsu), or commercial modification (fmsuc). |
Response
A JSON object with search_metadata (request id, credits used and remaining) and the result data: images_results. Groups and fields depend on the content of each page, so treat every field as optional.
Examples
cURL
curl "https://serpfast.com/api/v1/yahoo/images?p=coffee&yahoo_domain=search.yahoo.com&b=1" \
-H "Authorization: Bearer $SERPFAST_KEY"Node.js 18+
const params = new URLSearchParams({
"p": "coffee",
"yahoo_domain": "search.yahoo.com",
"b": 1
});
const res = await fetch(`https://serpfast.com/api/v1/yahoo/images?${params}`, {
headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);Python
import os, requests
params = {
"p": "coffee",
"yahoo_domain": "search.yahoo.com",
"b": 1
}
res = requests.get(
"https://serpfast.com/api/v1/yahoo/images",
params=params,
headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
timeout=120,
)
print(res.json())