Dokumentasi API tersedia dalam bahasa Inggris.

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.

ParameterTypeDescription
prequiredstringText or search operators to send to Yahoo.Up to 2,000 characters.
yahoo_domainstringYahoo regional search host, for example fr.search.yahoo.com. A regional prefix such as fr is also accepted.Default: search.yahoo.com.
bintegerOne-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.

ParameterTypeDescription
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())