Bing Images API
Our Bing Images API allows you to scrape SERP results from Bing Images. The API is accessed through the following endpoint: /search?engine=bing_images
.
A user may query the following: https://serpapi.com/search?engine=bing_images
utilizing a GET request. Head to the playground for a live and interactive demo.
API Parameters
Geographic Location
mkt
Optional
The market where the results come from (e.g. en-US
). Typically, mkt is the country where the user is making the request from. However, it could be a different country if the user is not located in a country where Bing Images API delivers results. The market must be in the form <language code>-<country code>. For example, en-US. The string is case insensitive. For a list of possible market values, see Market Codes.
NOTE: If known, you are encouraged to always specify the market. Specifying the market helps Bing route the request and return an appropriate and optimal response. If you specify a market that is not listed in Market Codes, Bing Images API uses a best fit market code based on an internal mapping that is subject to change.
This parameter and the cc query parameter are mutually exclusive—do not specify both.
Localization
cc
Optional
Parameter defines the country to search from. It follows the 2-character ISO_3166-1 format. (e.g., us
for United States, de
for Germany, gb
for United Kingdom, etc.).
Pagination
Advanced Bing Images Parameters
imagesize
Optional
Parameter is used for filtering images by size. It can be set to:small
- Smallmedium
- Mediumlarge
- Largewallpaper
- Extra Large
color2
Optional
Parameter is used for filtering images by color. It can be set to:color
- Color Onlybw
- Black & whiteFGcls_RED
- RedFGcls_ORGANGE
- OrangeFGcls_YELLOW
- YellowFGcls_GREEN
- GreenFGcls_TEAL
- TealFGcls_BLUE
- BlueFGcls_PURPLE
- PurpleFGcls_PINK
- PinkFGcls_BROWN
- BrownFGcls_BLACK
- BlackFGcls_GRAY
- GrayFGcls_WHITE
- White
photo
Optional
Parameter is used for filtering images by image type. It can be set to:photo
- Photoclipart
- Clipartlinedrawing
- Line Drawinganimatedgif
- Animated GIFtransparent
- Transparent
aspect
Optional
Parameter is used for filtering images by layout. It can be set to:square
- Squarewide
- Widetall
- Tall
face
Optional
Parameter is used for filtering images by people. It can be set to:face
- Faces Onlyportrait
- Head & Shoulders
age
Optional
Parameter is used for filtering images by date. It can be set to:lt1440
- Past 24 hourslt10080
- Past weeklt43200
- Past monthlt525600
- Past year
license
Optional
Parameter is used for filtering images by license. It can be set to:Type-Any
- All Creative CommonsL1
- Public DomainL2_L3_L4_L5_L6_L7
- Free to share and useL2_L3_L4
- Free to share and use commerciallyL2_L3_L5_L6
- Free to modify, share and useL2_L3
- Free to modify, share, and use commercially
Serpapi Parameters
device
Optional
Parameter defines the device to use to get the results. It can be set to desktop
(default) to use a regular browser, tablet
to use a tablet browser (currently using iPads), or mobile
to use a mobile browser (currently using iPhones).
no_cache
Optional
Parameter will force SerpApi to fetch the Bing Images results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false
(default) to allow results from the cache, or true
to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false
(default) to open an HTTP connection and keep it open until you got your search results, or true
to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false
(default) or true
. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
API Results
JSON Results
JSON output includes structured data for "Images Results", "Related Searches", "Suggested Searches", "Refined Searches", and "Shopping Results".
A search status is accessible through search_metadata.status
. It flows this way: Processing
-> Success
|| Error
. If a search has failed, error
will contain an error message. search_metadata.id
is the search ID inside SerpApi.
HTML Results
HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from Bing Images.
API Examples
Example results for coffee
Images results can contain thumbnail
, link
, title
, original
, source
, size
, domain
, source_logo
, description
, badges
and position
.
{
"search_metadata": {
"id": "66f3d889ab6e3306efea1d46",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/fd50075aaf610a25/66f3d889ab6e3306efea1d46.json",
"created_at": "2024-09-25 09:31:53 UTC",
"processed_at": "2024-09-25 09:31:53 UTC",
"bing_images_url": "https://www.bing.com/images/search?q=coffee&qft=",
"raw_html_file": "https://serpapi.com/searches/fd50075aaf610a25/66f3d889ab6e3306efea1d46.html",
"total_time_taken": 1.37
},
"search_parameters": {
"engine": "bing_images",
"q": "coffee",
"device": "desktop"
},
"images_results": [
{
"thumbnail": "https://tse4.mm.bing.net/th/id/OIP.4WUjqZXl4tBdfKEwgN9FKAHaE7?w=232&h=180&c=7&r=0&o=5&pid=1.7",
"link": "https://www.bing.com/images/search?view=detailV2&ccid=4WUjqZXl&id=CF0D20AA2EE1EDB2A107BB83134E0B8100A9DFFB&thid=OIP.4WUjqZXl4tBdfKEwgN9FKAHaE7&mediaurl=https%3a%2f%2fwww.myweekly.co.uk%2fwp-content%2fuploads%2fsites%2f9%2f2018%2f06%2fiStock-814684194-coffee-x.jpg&cdnurl=https%3a%2f%2fth.bing.com%2fth%2fid%2fR.e16523a995e5e2d05d7ca13080df4528%3frik%3d%252b9%252bpAIELThODuw%26pid%3dImgRaw%26r%3d0&exph=1278&expw=1920&q=coffee&simid=607988093767124911&FORM=IRPRST&ck=3C1F7CA988163A2EEF6F1D083516A5D5&selectedIndex=0&itb=0",
"title": "The 5 Health Benefits Of Ditching Coffee! - My Weekly",
"size": "1920×1278",
"source": "https://www.myweekly.co.uk/2018/07/02/the-5-health-benefits-of-ditching-coffee/",
"domain": "myweekly.co.uk",
"original": "https://www.myweekly.co.uk/wp-content/uploads/sites/9/2018/06/iStock-814684194-coffee-x.jpg",
"description": "coffee cup cofee ditching benefits health beans hot latte istockphoto pic background",
"position": 1
},
{
"thumbnail": "https://tse3.mm.bing.net/th/id/OIP.OVYXu9Nt8b6SjNyb8Ppg9QHaEK?w=274&h=180&c=7&r=0&o=5&pid=1.7",
"link": "https://www.bing.com/images/search?view=detailV2&ccid=OVYXu9Nt&id=8FC5E2797A94A8B9A79CB4D1640B08F6729808FB&thid=OIP.OVYXu9Nt8b6SjNyb8Ppg9QHaEK&mediaurl=https%3a%2f%2fsvasthaayurveda.com%2fwp-content%2fuploads%2f2015%2f05%2fcup-of-coffee-and-roasted-beans-on-wood-table-uhd-4k-wallpaper.jpg&cdnurl=https%3a%2f%2fth.bing.com%2fth%2fid%2fR.395617bbd36df1be928cdc9bf0fa60f5%3frik%3d%252bwiYcvYIC2TRtA%26pid%3dImgRaw%26r%3d0&exph=2160&expw=3840&q=coffee&simid=608000102492626356&FORM=IRPRST&ck=F4CDAC1747A014FFEFB3AB735E1CE4D4&selectedIndex=1&itb=0",
"title": "Is Your Daily Coffee affecting your health? An Ayurvedic View on ...",
"size": "3840×2160",
"source": "https://svasthaayurveda.com/the-highs-and-lows-of-caffeine-consumption-an-ayurvedic-perspective/",
"domain": "svasthaayurveda.com",
"original": "https://svasthaayurveda.com/wp-content/uploads/2015/05/cup-of-coffee-and-roasted-beans-on-wood-table-uhd-4k-wallpaper.jpg",
"description": "coffee beans caffeine",
"position": 2
},
{
"thumbnail": "https://tse1.mm.bing.net/th/id/OIP._Vj7WCGHfBEE_6g-b45inwHaEo?w=246&h=180&c=7&r=0&o=5&pid=1.7",
"link": "https://www.bing.com/images/search?view=detailV2&ccid=%2fVj7WCGH&id=BB8B8A1CBC8A36B494835F09A61400D67E4F8632&thid=OIP._Vj7WCGHfBEE_6g-b45inwHaEo&mediaurl=https%3a%2f%2fth.bing.com%2fth%2fid%2fR.fd58fb5821877c1104ffa83e6f8e629f%3frik%3dMoZPftYAFKYJXw%26riu%3dhttp%253a%252f%252f4.bp.blogspot.com%252f-s9w7li-AAd4%252fUFdl0Q6KcUI%252fAAAAAAAAAgg%252fqRYI1u2b2GE%252fs1600%252fcup-coffee.jpg%26ehk%3dn6UVeHkl362syEos0Ide%252bGD0R4XyqX8X1Do96ig0Za0%253d%26risl%3d%26pid%3dImgRaw%26r%3d0&exph=1000&expw=1600&q=coffee&simid=608034930364263774&FORM=IRPRST&ck=C8C81615B7B7463AAF15880F3A1C0443&selectedIndex=2&itb=0",
"title": "Dr. Mark's Health Tips: Coffee... not the bad guy it is portrayed to be",
"size": "1600×1000",
"source": "https://drmarkscorner.blogspot.com/2012/09/coffee-not-bad-guy-it-is-portrayed-to-be.html",
"domain": "drmarkscorner.blogspot.com",
"source_logo": "https://tse4.mm.bing.net/th/id/ODF.kCKFU1-d0l3Elu2Vvbpmew?w=12&h=12&c=7&rs=1&p=0&pid=1.7",
"original": "https://4.bp.blogspot.com/-s9w7li-AAd4/UFdl0Q6KcUI/AAAAAAAAAgg/qRYI1u2b2GE/s1600/cup-coffee.jpg",
"description": "portrayed",
"position": 3
},
...
],
"suggested_searches": [
{
"thumbnail": "https://tse2.mm.bing.net/th?q=1+Cup+Coffee&w=42&h=42&c=7&rs=1&p=0&o=5&pid=1.7&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=1+Cup+Coffee&FORM=RESTAB",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=1+Cup+Coffee",
"name": "1 Cup Coffee"
},
{
"thumbnail": "https://tse1.mm.bing.net/th?q=Great+Cup+of+Coffee&w=42&h=42&c=7&rs=1&p=0&o=5&pid=1.7&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=Great+Cup+of+Coffee&FORM=RESTAB",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Great+Cup+of+Coffee",
"name": "Great Cup of Coffee"
},
{
"thumbnail": "https://tse1.mm.bing.net/th?q=Good+Cup+of+Coffee&w=42&h=42&c=7&rs=1&p=0&o=5&pid=1.7&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=Good+Cup+of+Coffee&FORM=RESTAB",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Good+Cup+of+Coffee",
"name": "Good Cup of Coffee"
},
...
],
"refined_searches": [
{
"thumbnail": "https://tse3.mm.bing.net/th?q=Coffee+Cup+HD&w=120&h=120&c=1&rs=1&qlt=90&cb=1&pid=InlineBlock&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1&mw=247",
"link": "https://www.bing.com/images/search?q=Coffee+Cup+HD&qft=&FORM=IRTRRL",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Coffee+Cup+HD",
"name": "Cup HD"
},
{
"thumbnail": "https://tse3.mm.bing.net/th?q=Coffee+Cup+Pic&w=120&h=120&c=1&rs=1&qlt=90&cb=1&pid=InlineBlock&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1&mw=247",
"link": "https://www.bing.com/images/search?q=Coffee+Cup+Pic&qft=&FORM=IRTRRL",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Coffee+Cup+Pic",
"name": "Cup Pic"
},
{
"thumbnail": "https://tse4.mm.bing.net/th?q=Best+Type+of+Coffee&w=120&h=120&c=1&rs=1&qlt=90&cb=1&pid=InlineBlock&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1&mw=247",
"link": "https://www.bing.com/images/search?q=Best+Type+of+Coffee&qft=&FORM=IRTRRL",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Best+Type+of+Coffee",
"name": "Best Type"
},
...
],
"related_searches": [
{
"thumbnail": "https://tse3.mm.bing.net/th?q=Coffee+Mugs&w=185&h=54&c=1&rs=1&qlt=90&pid=InlineBlock&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=Coffee+Mugs&qft=&fsm=1&FORM=SHOPSO",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Coffee+Mugs",
"name": "Coffee Mugs"
},
{
"thumbnail": "https://tse2.mm.bing.net/th?q=Coffee+Beans&w=185&h=54&c=1&rs=1&qlt=90&pid=InlineBlock&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=Coffee+Beans&qft=&fsm=1&FORM=SHOPSO",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Coffee+Beans",
"name": "Coffee Beans"
},
{
"thumbnail": "https://tse1.mm.bing.net/th?q=Cold+Brew+Coffee+Maker&w=185&h=54&c=1&rs=1&qlt=90&pid=InlineBlock&mkt=en-CA&cc=CA&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=Cold+Brew+Coffee+Maker&qft=&fsm=1&FORM=SHOPSO",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Cold+Brew+Coffee+Maker",
"name": "Cold Brew Coffee Maker"
}
],
"serpapi_pagination": {
"next": "https://serpapi.com/search.json?count=35&device=desktop&engine=bing_images&first=36&q=coffee",
"current": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=coffee"
}
}
Example results for macbook
Some search result might contain shopping_results
and related_searches
{
"search_metadata": {
"id": "6357b2bc94489355d5b29582",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/2014577a11af2730/6357b2bc94489355d5b29582.json",
"created_at": "2022-10-25 09:56:12 UTC",
"processed_at": "2022-10-25 09:56:12 UTC",
"bing_images_url": "https://www.bing.com/images/search?q=macbook",
"raw_html_file": "https://serpapi.com/searches/2014577a11af2730/6357b2bc94489355d5b29582.html",
"total_time_taken": 2.46
},
"search_parameters": {
"engine": "bing_images",
"q": "macbook",
"device": "desktop"
},
"images_results": [
{
"thumbnail": "https://serpapi.com/searches/6357b2bc94489355d5b29582/images/0ed2e92a3b29f18f007fd69172bea2472acbadcec9ef3f78f08b4d0d939395f6.gif",
"link": "<Link to the image>",
"title": "Apple: Končíme s opravami MacBooků z let 2013 a 2014, jsou zastaralé – Letem světe…",
"size": "2016 x 1512 · jpeg",
"source": "https://www.letemsvetemapplem.eu/2020/05/13/apple-koncime-s-opravami-macbooku-z-let-2013-a-2014-jsou-zastarale/",
"domain": "letemsvetemapplem.eu",
"original": "https://www.letemsvetemapplem.eu/wp-content/uploads/2020/05/macbook-2013.jpg",
"position": 1
},
{
"thumbnail": "https://serpapi.com/searches/6357b2bc94489355d5b29582/images/0ed2e92a3b29f18f744e816940abcce58b9a3293e151813309d009f90574ef5e.gif",
"link": "<Link to the image>",
"title": "Top Laptop: January 2011",
"size": "400 x 319 · jpeg",
"source": "http://top-laptop789.blogspot.com/2011_01_01_archive.html",
"domain": "top-laptop789.blogspot.com",
"original": "http://1.bp.blogspot.com/_iFwJ86zvGY4/TSwwOgJNxpI/AAAAAAAAAAc/vExe_nkjjnE/s400/apple_macbook.jpg",
"description": "macbook apple january tuesday",
"position": 2
},
{
"thumbnail": "https://serpapi.com/searches/6357b2bc94489355d5b29582/images/0ed2e92a3b29f18f05ef4a8ce56ac5a7a80bc1b3eb6c94bef4b39093a01ae1b4.gif",
"link": "<Link to the image>",
"title": "MacBook",
"size": "500 x 500 · jpeg",
"source": "https://artem.myshopunity.com/220/d_seo_module/macbook",
"domain": "artem.myshopunity.com",
"original": "https://artem.myshopunity.com/220/d_seo_module/image/cache/catalog/demo/macbook_1-500x500.jpg",
"description": "macbook",
"position": 3
},
...
],
"suggested_searches": [
{
"thumbnail": "https://tse4.mm.bing.net/th?q=Black+MacBook&w=42&h=42&c=7&rs=1&p=0&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=Black+MacBook&FORM=RESTAB",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Black+MacBook",
"name": "Black MacBook"
},
{
"thumbnail": "https://tse3.mm.bing.net/th?q=New+Apple+MacBook+Air&w=42&h=42&c=7&rs=1&p=0&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=New+Apple+MacBook+Air&FORM=RESTAB",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=New+Apple+MacBook+Air",
"name": "New Apple MacBook Air"
},
{
"thumbnail": "https://tse1.mm.bing.net/th?q=Laptop+Apple+MacBook&w=42&h=42&c=7&rs=1&p=0&o=5&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate&t=1",
"link": "https://www.bing.com/images/search?q=Laptop+Apple+MacBook&FORM=RESTAB",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=Laptop+Apple+MacBook",
"name": "Laptop Apple MacBook"
},
...
],
"shopping_results": [
{
"thumbnail": "https://tse2.mm.bing.net/th?id=OP.ttYCLJ2%2f3mVc2Q474C474&w=160&h=160&rs=1&o=5&pid=21.1",
"link": "<Link to the item>",
"price": "$692.99",
"title": "Macbook Air 13 (2020) Good",
"seller": "ItsWorthMore.com",
"views": "Refurbished",
"position": 1
},
{
"thumbnail": "https://tse1.mm.bing.net/th/id/OP.Tt0fVG1DzlfPiw474C474?w=160&h=160&rs=1&o=5&pid=21.1",
"link": "<Link to the item>",
"price": "$1,039.99",
"title": "Macbook Air 13 (2022) Excellent",
"seller": "ItsWorthMore.com",
"views": "Refurbished",
"position": 2
},
{
"thumbnail": "https://tse4.mm.bing.net/th?id=OP.F%2f0ep5IdjJKOPA474C474&w=200&h=160&rs=1&o=5&pid=21.1",
"link": "<Link to the item>",
"price": "$149.00",
"title": "Used Apple A Grade Macbook Pro 13.3-Inch Laptop (Glossy) 2.4Ghz Dual Core i5 (Late 2011) Md313ll/A 320 GB HD 4 GB Memory 1280X800 Display Macos Sierra",
"seller": "Walmart",
"shipping": "Free shipping",
"position": 3
},
...
],
"serpapi_pagination": {
"next": "https://serpapi.com/search.json?count=35&device=desktop&engine=bing_images&first=36&q=macbook",
"current": "https://serpapi.com/search.json?device=desktop&engine=bing_images&q=macbook"
}
}
JSON structure overview
{
...
"images_results": [
{
"thumbnail": "String - URL to the image thumbnail",
"position": "Integer - Position of the image result",
"title": "String - Title of the image result",
"link": "String - URL to the image result",
"size": "String - Size of the image result",
"original": "String - URL to the original upload of the image result",
"source": "String - Source URL of the website containing the image result",
"domain": "String - Domain of the website containing the image result",
"source_logo": "String - URL to the source logo of the website containing the image result",
"description": "String - Description of the image result",
"badges": "String - Badges of the image result",
}
],
"related_searches": [
{
"thumbnail": "String - URL to the related search thumbnail",
"link": "String - URL to the related search",
"name": "String - Related query (e.g. `Drip Coffee`)",
"serpapi_link": "String - URL to SerpApi Bing Images API"
}
],
"suggested_searches": [
{
"thumbnail": "String - URL to the suggested search thumbnail",
"link": "String - URL to the suggested search",
"name": "String - Suggested query (e.g. `Coffee Mug`)",
"serpapi_link": "String - URL to SerpApi Bing Images API"
}
],
"refined_searches": [
{
"thumbnail": "String - URL to the refined search thumbnail",
"link": "String - URL to the refined search",
"name": "String - Refined query (e.g. `Drip`)",
"serpapi_link": "String - URL to SerpApi Bing Images API"
}
],
"shopping_results": [
{
"position": "Integer - Position of the item result",
"link": "String - URL to the item",
"price": "String - Price to the item",
"list_price": "String - List price to the item",
"title": "String - Title of the item result",
"seller": "String - Seller's name of the item result",
"thumbnail": "String - URL to the item thumbnail",
"badges": "String - Badges of the item",
"shipping": "String - Shipping method of the item",
"rating": "Integer - Rating of the item",
"reviews": "Integer - Reviews of the item",
"reviews_source": "String - Reviews source of the item",
}
],
...
}