Logo SearchApi

Bing Images API

GET   /api/v1/search?engine=bing_images

Bing Images API allows you to retrieve high-quality, up-to-date images and metadata for any search query, enabling you to integrate Bing's powerful image search capabilities directly into your applications.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the query you want to search. You can use anything that you would use in a regular Bing Images search.

Device

  • Name
    device
    Required
    Optional
    Description

    The default parameter desktop defines the search on a desktop device. The mobile parameter defines the search on a mobile device. The tablet parameter defines the search on a tablet device.

Localization

  • Name
    market_code
    Required
    Optional
    Description

    Defines the country for search results. Format is language-country, like en-US. For a list of market values, check the full list of supported Bing market_code codes.

    Note: the market_code parameter can't be used together with country_code parameter.

  • Name
    country_code
    Required
    Optional
    Description

    Specifies the country for the search results if market_code is not specified. Defaults to US if unspecified or market_code is not used. Check the full list of supported Bing coutry_code countries.

    Note: the country_code parameter can't be used together with market_code parameter.

  • Name
    language
    Required
    Optional
    Description

    Sets the language for user interface text. Use 2-letter (ISO 639-1) or 4-letter codes ('-'). Defaults to en (English) if unspecified or unsupported. Check the full list of supported Bing language languages.

Filters

  • Name
    size
    Required
    Optional
    Description

    This parameter controls the size of your search results. There are few options available: small, medium, large and extra_large.

  • Name
    min_size
    Required
    Optional
    Description

    Use this parameter to filter images by minimum width and height. Enter the size in the format WidthxHeight (e.g., 800x600).

  • Name
    time_period
    Required
    Optional
    Description

    This parameter restricts results to URLs based on date. Supported values are: last_day, last_week, last_month, last_year.

  • Name
    color
    Required
    Optional
    Description

    This parameter controls the color of your search results. These options are available: black_and_white, color, red, orange, yellow, green, teal, blue, purple, pink, brown, black, gray,white.

  • Name
    image_type
    Required
    Optional
    Description

    This parameter controls the type of your search results. There are only few options that are available: photo, gif, clipart, line_drawing, transparent, face and head_and_shoulders.

  • Name
    usage_rights
    Required
    Optional
    Description

    This parameter controls the usage rights of your search results. Options that are available: public_domain, creative_commons_licenses, free_to_share_and_use, free_to_share_and_use_commercial, free_to_modify_share_and_use, free_to_modify_share_and_use_commercial.

  • Name
    aspect_ratio
    Required
    Optional
    Description

    This parameter filters images based on aspect ratio. Supported values are:

    • square - width equals height.
    • tall - height greater than width.
    • wide - width greater than height.

Pagination

  • Name
    page
    Required
    Optional
    Description

    This parameter indicates which page of results to return. By default, it is set to 1.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to bing_images.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=bing_images&q=grape
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_images",
  "q": "grape"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "search_metadata": {
        "id": "search_vr7K8ndWgWe1idN83P45k2mY",
        "status": "Success",
        "created_at": "2025-08-11T18:35:51Z",
        "request_time_taken": 1.3,
        "parsing_time_taken": 0.1,
        "total_time_taken": 1.4,
        "request_url": "https://www.bing.com/images/search?q=grape&mkt=en-us&first=1",
        "html_url": "https://www.searchapi.io/api/v1/searches/search_vr7K8ndWgWe1idN83P45k2mY.html",
        "json_url": "https://www.searchapi.io/api/v1/searches/search_vr7K8ndWgWe1idN83P45k2mY"
    },
    "search_parameters": {
        "engine": "bing_images",
        "q": "grape",
        "device": "desktop"
    },
    "search_information": {
        "query_displayed": "grape"
    },
    "suggestions": [
        {
            "title": "Grapes Clip Art",
            "link": "https://www.bing.com/images/search?q=Grapes+Clip+Art&FORM=RESTAB",
            "thumbnail": "https://thfvnext.bing.com/th?q=Grapes+Clip+Art&w=42&h=42&c=7&rs=1&p=0&o=5&cb=thfvnext&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate&t=1"
        },
        ...
    ],
    "images": [
        {
            "position": 1,
            "title": "The meaning and symbolism of the word - «Grapes»",
            "source": {
                "name": "weknowyourdreams.com",
                "link": "http://weknowyourdreams.com/grapes.html"
            },
            "original": {
                "link": "https://th.bing.com/th/id/R.28d1c9dd98f97cca56a351e1b3deee0f?rik=V9vVsHbOOViWVw&riu=http%3a%2f%2fweknowyourdreams.com%2fimages%2fgrapes%2fgrapes-02.jpg&ehk=gW7u0v1vlYi%2fWLser9zzkJpw2W4BofaSRK4XfrJ3weI%3d&risl=1&pid=ImgRaw&r=0",
                "width": "474",
                "height": "379"
            },
            "thumbnail": "https://thfvnext.bing.com/th/id/OIP.KNHJ3Zj5fMpWo1Hhs97uDwAAAA?w=249&h=199&c=7&r=0&o=5&cb=thfvnext&pid=1.7"
        },
        ...
    ],
    "related_searches": [
        {
            "query": "Grape Seed Oil",
            "link": "https://www.bing.com/images/search?q=Grape+Seed+Oil&qft=&fsm=1&FORM=SHOPSO",
            "thumbnail": "https://thfvnext.bing.com/th?q=Grape+Seed+Oil&w=180&h=52&c=1&rs=1&qlt=90&cb=thfvnext&pid=InlineBlock&mkt=en-US&cc=US&setlang=en&adlt=moderate&t=1"
        },
        ...
    ]
}

Images

Images
GET
https://www.searchapi.io/api/v1/search?engine=bing_images&q=pineapple
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_images",
  "q": "pineapple"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "images": [
        {
            "position": 1,
            "title": "Pineapple 101: Benefits, Buying, And Storing Pineapple",
            "source": {
                "name": "liveeatlearn.com",
                "link": "https://www.liveeatlearn.com/pineapple/"
            },
            "original": {
                "link": "https://www.liveeatlearn.com/wp-content/uploads/2023/05/How-to-Cut-Pineapple-01.jpg",
                "width": "1200",
                "height": "1800"
            },
            "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAEALAAAAAABAAEAAAIBTAA7"
        },
        {
            "position": 2,
            "title": "The meaning and symbolism of the word - «Pineapple»",
            "source": {
                "name": "weknowyourdreams.com",
                "link": "http://weknowyourdreams.com/pineapple.html"
            },
            "original": {
                "link": "https://th.bing.com/th/id/R.38c93f5f147cd00f38a488b7cd7a50ad?rik=%2bSa%2bOIG8GnzYKQ&riu=http%3a%2f%2fweknowyourdreams.com%2fimages%2fpineapple%2fpineapple-08.jpg&ehk=KV9%2fnGjs5ZfzkUUPF1FA6rtEWUtocGJ0iN2UhsO8fXg%3d&risl=&pid=ImgRaw&r=0",
                "width": "3944",
                "height": "5116"
            },
            "thumbnail": "https://tse1.mm.bing.net/th/id/ODF.IQxLp9fVDj55WcjZYEIDjQ?w=12&h=12&c=7&rs=1&p=0&pid=1.7"
        },
        ...
    ]
}

Suggestions

Suggestions
GET
https://www.searchapi.io/api/v1/search?engine=bing_images&q=strawberry
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_images",
  "q": "strawberry"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "suggestions": [
        {
            "title": "Fruits",
            "link": "https://www.bing.com/images/search?q=Fruits&FORM=RESTAB",
            "thumbnail": "https://tse2.mm.bing.net/th?q=Fruits&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"
        },
        {
            "title": "Real Strawberry",
            "link": "https://www.bing.com/images/search?q=Real+Strawberry&FORM=RESTAB",
            "thumbnail": "https://tse4.mm.bing.net/th?q=Real+Strawberry&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"
        },
        ...
    ]
}

Shopping Ads

Shopping Ads
GET
https://www.searchapi.io/api/v1/search?device=mobile&engine=bing_images&q=iphone+15
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_images",
  "q": "iphone 15",
  "device": "mobile"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "shopping_ads": [
        {
            "position": 1,
            "title": "Apple iPhone 16 - 512GB - Pink - AT&T",
            "seller": "AT&T",
            "link": "https://d.agkn.com/pixel/4102/?che=",
            "price": "$0.00 now",
            "extracted_price": 0,
            "installment": {
                "down_payment": "$0.00 now",
                "extracted_down_payment": 0,
                "months": "36",
                "extracted_months": 36,
                "cost_per_month": "$31.39",
                "extracted_cost_per_month": 31.39
            },
            "image": "https://thf.bing.com/th?id=OPHS.6Nso2LrBHf%2fNPw474C474&w=140&h=140&rs=1&r=0&o=5&pid=21.1"
        },
        ...
    ]
}