Skip to content
Gridlode
Docs · Reference

Bing Images Search

GET /v1/search/bing/images1 credit / requestcache 60 min

Live Bing Images results for any query and market: full-size image URL, thumbnail, title, the page the image appears on, its domain and the image's width and height, with Bing's size, color, type, layout, license and date filters and SafeSearch. 35 images per page. Verification pages are detected and never charged.

Query parameters

q
string · required
Search query.
cc
string
Market (country) to search, e.g. us, gb, de, in.
Default: "us"
setlang
string
Interface language, e.g. en, de, pt-BR.
Default: "en"
size
string
Image size: small, medium, large or wallpaper (extra large).
Default: "any"
Allowed: any, small, medium, large, wallpaper
color
string
Color only, black & white (bw), or a dominant color.
Default: "any"
Allowed: any, color, bw, red, orange, yellow, green, teal, blue, purple, pink, brown, black, gray, white
type
string
Image type: photo, clipart, line drawing, animated GIF or transparent.
Default: "any"
Allowed: any, photo, clipart, linedrawing, animatedgif, transparent
layout
string
Aspect ratio.
Default: "any"
Allowed: any, square, wide, tall
license
string
Usage rights as Bing labels them (always check the source page's license).
Default: "any"
Allowed: any, creative_commons, public_domain, free_share, free_share_commercial, free_modify, free_modify_commercial
freshness
string
Only images Bing found in the past day, week, month or year.
Default: "any"
Allowed: any, day, week, month, year
safe
string
SafeSearch level.
Default: "moderate"
Allowed: off, moderate, strict
page
integer
Results page (1-20), 35 images per page.
Default: 1
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/search/bing/images?q=golden%20retriever" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Bing Images Search API page.