Bing Images API documentation

Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

curl --fail-with-body --get 'https://api.litescrape.com/api/bing/images' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --data-urlencode 'q=red panda' \ --data-urlencode 'first=1' \ --data-urlencode 'count=10' \ --data-urlencode 'mkt=en-US' \ --data-urlencode 'safeSearch=moderate'

JSON POST request example

POST to https://api.litescrape.com/api/bing/images with Content-Type: application/json and your Authorization: Bearer header.

{
  "q": "red panda",
  "count": 10,
  "mkt": "en-US"
}

// request reference

Bing Images parameters

Send query parameters with GET /api/bing/images. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Image search

q

QueryRequired

Image search query, from 1 through 2,048 characters after trimming. Control characters are rejected.

Type string · GET query or POST JSON

Example / input hint: red panda

Minimum characters: 1
Maximum characters: 2048

Pagination and localization

first

First resultOptional

One-based Bing result offset, from 1 through 10,000.

Type integer · GET query or POST JSON · Default 1

Prefer litescrape_pagination.next when returned. Bing may reorder or repeat images between requests.
Minimum: 1
Maximum: 10000

count

Result limitOptional

Maximum images to return, from 1 through 100. Defaults to 35.

Type integer · GET query or POST JSON · Default 35

Bing may return fewer images. Follow the pagination link to retrieve another batch.
Minimum: 1
Maximum: 100

mkt

MarketOptional

Optional language-country market, such as en-US. Cannot be combined with cc.

Type string · GET query or POST JSON

Example / input hint: en-US

Pattern: ^[a-zA-Z]{2}-[a-zA-Z]{2}$

cc

CountryOptional

Optional two-letter country code. Cannot be combined with mkt.

Type string · GET query or POST JSON

Example / input hint: US

Pattern: ^[a-zA-Z]{2}$

safeSearch

SafeSearchOptional

Bing content filter: off, moderate, or strict. Case-insensitive; defaults to moderate.

Type string · GET query or POST JSON · Default moderate

Accepted valuesoffmoderatestrict

Bing may enforce stricter filtering for some markets.

Image filters

imagesize

Image sizeOptional

Bing image size bucket: small, medium, large or wallpaper (extra large).

Type string · GET query or POST JSON

Accepted valuessmallmediumlargewallpaper

photo

Image typeOptional

Photographs, clipart, line drawings, animated GIFs or images with transparent backgrounds.

Type string · GET query or POST JSON

Accepted valuesphotoclipartlinedrawinganimatedgiftransparent

aspect

Aspect ratioOptional

Filter to square, wide or tall images.

Type string · GET query or POST JSON

Accepted valuessquarewidetall

color2

ColorOptional

Use color for any color, bw for black and white, or a dominant color: FGcls_RED, FGcls_ORANGE, FGcls_YELLOW, FGcls_GREEN, FGcls_TEAL, FGcls_BLUE, FGcls_PURPLE, FGcls_PINK, FGcls_BROWN, FGcls_BLACK, FGcls_GRAY or FGcls_WHITE.

Type string · GET query or POST JSON

Accepted valuescolorbwFGcls_REDFGcls_ORANGEFGcls_YELLOWFGcls_GREENFGcls_TEALFGcls_BLUEFGcls_PURPLEFGcls_PINKFGcls_BROWNFGcls_BLACKFGcls_GRAYFGcls_WHITE

face

PeopleOptional

Use face for just faces or portrait for head-and-shoulders images.

Type string · GET query or POST JSON

Accepted valuesfaceportrait

age

RecencyOptional

Bing date filter: lt1440 (past 24 hours), lt10080 (past week), lt43200 (past month) or lt525600 (past year).

Type string · GET query or POST JSON

Accepted valueslt1440lt10080lt43200lt525600

license

LicenseOptional

Use creativecommons for all Creative Commons results, L1 for public domain, or native license categories L2 through L7. Bing also supports grouped categories.

Type string · GET query or POST JSON

Accepted valuesL1L2L3L4L5L6L7L2_L3L2_L3_L4L2_L3_L5_L6L2_L3_L4_L5_L6_L7creativecommons

L2_L3_L4_L5_L6_L7: free to share and use. L2_L3_L4: free to share and use commercially. L2_L3_L5_L6: free to modify, share and use. L2_L3: free to modify, share and use commercially.
Bing classifies usage rights; confirm the license on the source page before reusing an image.

qft

Advanced filtersOptional

Optional native Bing Images qft filter expression, up to 2,048 characters without control characters.

Type string · GET query or POST JSON

Example / input hint: +filterui:photo-photo

Named image filters override the same category in qft and preserve unrelated categories. Without named filters, qft is passed through unchanged. Filter matching and availability are controlled by Bing.
Maximum characters: 2048

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, images_results, pagination, litescrape_pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

{
  "search_metadata": {
    "id": "illustrative-bing-images",
    "status": "Success",
    "json_endpoint": "https://api.litescrape.com/api/bing/images",
    "created_at": "2026-10-09 00:00:00 UTC",
    "processed_at": "2026-10-09 00:00:00 UTC",
    "bing_url": "https://www.bing.com/images/search?q=red+panda&first=1&count=10&mkt=en-US&adlt=moderate",
    "total_time_taken": 0.5
  },
  "search_parameters": {
    "q": "red panda",
    "first": 1,
    "count": 10,
    "mkt": "en-US",
    "safeSearch": "moderate"
  },
  "images_results": [
    {
      "position": 1,
      "title": "Red panda",
      "link": "https://example.com/red-panda",
      "original": "https://example.com/red-panda.jpg",
      "thumbnail": "https://example.com/red-panda-thumb.jpg",
      "source": "example.com",
      "original_width": 1920,
      "original_height": 1080
    }
  ],
  "pagination": {
    "next": "https://www.bing.com/images/search?q=red+panda&first=11&count=10&mkt=en-US&adlt=moderate",
    "next_first": 11
  },
  "litescrape_pagination": {
    "next": "https://api.litescrape.com/api/bing/images?q=red+panda&first=11&count=10&mkt=en-US&safeSearch=moderate",
    "next_first": 11
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

Litescrape sells to AI agents - live prices and self-serve payment

Bing Images API

Integrate Bing Images

JSON POST request example

Bing Images parameters

Image search

Pagination and localization

Image filters

Work with the complete JSON response

More Bing APIs