API 문서는 영어로 제공됩니다.

Bing Images

Search Bing Images with size, color, date and license filters.

GET/api/v1/bing/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

Image search

ParameterTypeDescription
qrequiredstringImage search query, from 1 through 2,048 characters after trimming. Control characters are rejected.Up to 2,048 characters.

Pagination and localization

ParameterTypeDescription
firstintegerOne-based Bing result offset, from 1 through 10,000.Default: 1.Range: 1 to 10000.Prefer serpfast_pagination.next when returned. Bing may reorder or repeat images between requests.
countintegerMaximum images to return, from 1 through 100. Defaults to 35.Default: 35.Range: 1 to 100.Bing may return fewer images. Follow the pagination link to retrieve another batch.
mktstringOptional language-country market, such as en-US. Cannot be combined with cc.
ccstringOptional two-letter country code. Cannot be combined with mkt.
safeSearch"off" | "moderate" | "strict"Bing content filter: off, moderate, or strict. Case-insensitive; defaults to moderate.Default: moderate.Bing may enforce stricter filtering for some markets.

Image filters

ParameterTypeDescription
imagesize"small" | "medium" | "large" | "wallpaper"Bing image size bucket: small, medium, large or wallpaper (extra large).
photo"photo" | "clipart" | "linedrawing" | "animatedgif" | "transparent"Photographs, clipart, line drawings, animated GIFs or images with transparent backgrounds.
aspect"square" | "wide" | "tall"Filter to square, wide or tall images.
color2"color" | "bw" | "FGcls_RED" | "FGcls_ORANGE" | "FGcls_YELLOW" | "FGcls_GREEN" | "FGcls_TEAL" | "FGcls_BLUE" | "FGcls_PURPLE" | "FGcls_PINK" | "FGcls_BROWN" | "FGcls_BLACK" | "FGcls_GRAY" | "FGcls_WHITE"Use color for any color, bw for black and white, or a dominant color: FGcls_RED, FGcls_ORANGE, FGcls_YELLOW, FGcls_GREEN, FGcls_TEAL, FGcls_BLUE, FGcls_PURPLE, FGcls_PINK, FGcls_BROWN, FGcls_BLACK, FGcls_GRAY or FGcls_WHITE.
face"face" | "portrait"Use face for just faces or portrait for head-and-shoulders images.
age"lt1440" | "lt10080" | "lt43200" | "lt525600"Bing date filter: lt1440 (past 24 hours), lt10080 (past week), lt43200 (past month) or lt525600 (past year).
license"L1" | "L2" | "L3" | "L4" | "L5" | "L6" | "L7" | "L2_L3" | "L2_L3_L4" | "L2_L3_L5_L6" | "L2_L3_L4_L5_L6_L7" | "creativecommons"Use creativecommons for all Creative Commons results, L1 for public domain, or native license categories L2 through L7. Bing also supports grouped categories.L2_L3_L4_L5_L6_L7: free to share and use. L2_L3_L4: free to share and use commercially. L2_L3_L5_L6: free to modify, share and use. L2_L3: free to modify, share and use commercially.
qftstringOptional native Bing Images qft filter expression, up to 2,048 characters without control characters.Up to 2,048 characters.Named image filters override the same category in qft and preserve unrelated categories. Without named filters, qft is passed through unchanged. Filter matching and availability are controlled by Bing.

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/bing/images?q=red+panda&count=10&mkt=en-US" \
  -H "Authorization: Bearer $SERPFAST_KEY"
Node.js 18+
const params = new URLSearchParams({
  "q": "red panda",
  "count": 10,
  "mkt": "en-US"
});
const res = await fetch(`https://serpfast.com/api/v1/bing/images?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);
Python
import os, requests

params = {
  "q": "red panda",
  "count": 10,
  "mkt": "en-US"
}
res = requests.get(
    "https://serpfast.com/api/v1/bing/images",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())