Bing Images Search
Retrieve Bing image search results based on a query. Useful for visual content discovery, SEO analysis, tracking image trends, and understanding user intent through image searches on Bing.
If you already know that you want to use Bing Images Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.
At a Glance
| Field | Value |
|---|---|
| Name | Bing Images Search |
| Scraper | bing_images |
| Engine | bing_images_search |
| Website | Bing |
| Website URL | bingimages.com |
| Output Format | json |
| Version | 1.0.0 |
| Parameter Count | 13 |
| Parameter Groups | Search Query (1), Localization (1), Advanced Parameters (7), Geographic Location (1), Pagination (2), Request Controls (1) |
Required Parameters
If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.
| Field | Type | Group | Description |
|---|---|---|---|
q | string | Search Query | The keyword or phrase you want this search engine to look up. |
Available Parameters
The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.
Search Query
| Field | Type | Required | Description |
|---|---|---|---|
q | string | Yes | The keyword or phrase you want this search engine to look up. |
Localization
| Field | Type | Required | Description |
|---|---|---|---|
cc | string | No | Country code used to localize Bing-family results. |
Additional Constraints
cc:Options: 36 options. Examples:AR,AU,AT,BE,BR
Advanced Parameters
| Field | Type | Required | Description |
|---|---|---|---|
age | string | No | Filter image results by recency, such as the past 24 hours, week, month, or year. |
face | string | No | Filter image results to faces or portrait-style images. |
color | string | No | Filter image results by color. |
photo | string | No | Filter image results by content type, such as photo, clipart, or GIF. |
aspect | string | No | Filter image results by layout, such as square, wide, or tall. |
license | string | No | Filter image results by usage license. |
imagesize | string | No | Filter image results by size bucket. |
Additional Constraints
age:Options: 4 options. Examples:lt1440,lt10080,lt43200,lt525600face:Options: 2 options. Examples:face,portraitcolor:Options: 14 options. Examples:color,bw,FGcls_RED,FGcls_ORGANGE,FGcls_YELLOWphoto:Options: 7 options. Examples:photo,clipaty,linedrawing,animatedgif,animatedgifhttpsaspect:Options: 3 options. Examples:square,wide,talllicense:Options: 6 options. Examples:Type-Any,L1,L2_L3_L4_L5_L6_L7,L2_L3_L4,L2_L3_L5_L6imagesize:Options: 4 options. Examples:samll,medium,large,wallpaper
Geographic Location
| Field | Type | Required | Description |
|---|---|---|---|
mkt | string | No | Bing market code that combines language and country, such as en-US. |
Additional Constraints
mkt:Options: 37 options. Examples:es-ar,en-au,de-at,nl-be,fr-be
Pagination
| Field | Type | Required | Description |
|---|---|---|---|
count | string | No | Requested number of results to return on one page. |
first | string | No | Start position used for Bing-style pagination. |
Request Controls
| Field | Type | Required | Description |
|---|---|---|---|
device | string | No | Device type used when requesting results, such as desktop or tablet. |
Additional Constraints
device:Default:desktop;Options: 1 options. Examples:desktop
