JustSERPDocs
Bing

Bing Images

One page of Bing Images results (35 pictures), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `suggestions`, `images` and `related_searches`.

GET
/v1/bing/images

One page of Bing Images results (35 pictures), answered as the document: search_metadata, search_parameters, search_information (query_displayed), suggestions, images and related_searches. Filters: size, minimum size, colour, type, age, usage rights and aspect ratio. No shopping ads. zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

What to search for.

Lengthlength <= 1000
device?"desktop"

Anything but desktop is a 400.

Default"desktop"
Value in"desktop"
market_code?string

language-country from Bing's list (en-us...). Not with country_code.

country_code?string

Two letters from Bing's list.

Default"US"
language?string

Bing's list.

Default"en"
size?string
Value in"small""medium""large""extra_large"
min_size?string

At least this big, WIDTHxHEIGHT in pixels. Not with size.

Match^\d+x\d+$
color?string
Value in"black_and_white""color""red""orange""yellow""green""teal""blue""purple""pink""brown""black""gray""white"
image_type?string
Value in"clipart""line_drawing""gif""photo""transparent""face""head_and_shoulders"
time_period?string
Value in"last_day""last_week""last_month""last_year"
usage_rights?string
Value in"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"
aspect_ratio?string
Value in"square""wide""tall"
page?integer

35 pictures a page: first = (page-1)*35+1.

Range1 <= value <= 100
Default1

Response Body

The pictures, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Bing Images document.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

suggestions?array<>

"Refine your search for ...": narrower searches.

images?array<>
related_searches?array<>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/bing/images?q=mountain+bike&color=red&aspect_ratio=wide&page=2'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string",    "safe_search": "string"  },  "suggestions": [    {      "title": "string",      "link": "string",      "thumbnail": "string"    }  ],  "images": [    {      "position": 0,      "title": "string",      "source": {        "name": "string",        "link": "string"      },      "original": {        "link": "string",        "width": "string",        "height": "string"      },      "tag": "string",      "thumbnail": "string",      "related_thumbnails": [        "string"      ]    }  ],  "related_searches": [    {      "query": "string",      "link": "string"    }  ]}

Bing Maps GET

The places Bing Maps lists for a query, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `local_results`, `place_result` (a query with one match: that place is the only `local_results` item) and `pagination`.

Bing Videos GET

One page of Bing Videos results (50 on the first page, 35 on later ones), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `videos`, `shorts` (the portrait videos) and `pagination`.