Bing

Bing Images

Retrieve native Bing Images data.

post/v1/microsoft/images/search

Request

  • Base URL: https://api.prismcrawl.com
  • URL: https://api.prismcrawl.com/v1/microsoft/images/search
  • Auth: API key in header x-api-key

Request body

querystring required

Text to search for on the selected service. At most 8,192 UTF-8 bytes.

pageinteger

One-based page number.

countrystring

Two-letter country or storefront code, such as us or gb.

languagestring

Provider-supported language code, such as en.

safe'active' | 'strict' | 'moderate' | 'off'

Provider safe-search filtering.

device'desktop' | 'mobile' | 'tablet'

Device presentation for the source request.

htmlboolean

Return the encoded original response rather than parsed JSON.

zero_traceboolean

Do not archive source or parsed response artifacts.

mktstring

Bing market as a language-country pair; cannot be combined with country.

firstinteger

First result offset, starting at 1.

countinteger

Suggested number of source results per page; Bing may return fewer.

imagesize'small' | 'medium' | 'large' | 'wallpaper'

Filter images by imagesize.

color2'color' | 'bw' | 'FGcls_RED' | 'FGcls_ORANGE' | 'FGcls_YELLOW' | 'FGcls_GREEN' | 'FGcls_TEAL' | 'FGcls_BLUE' | 'FGcls_PURPLE' | 'FGcls_PINK' | 'FGcls_BROWN' | 'FGcls_BLACK' | 'FGcls_GRAY' | 'FGcls_WHITE'

Filter images by color2.

photo'photo' | 'clipart' | 'linedrawing' | 'animatedgif' | 'animatedgifhttps' | 'transparent' | 'shopping'

Filter images by photo.

aspect'square' | 'wide' | 'tall'

Filter images by aspect.

face'face' | 'portrait'

Filter images by face.

age'lt1440' | 'lt10080' | 'lt43200' | 'lt525600'

Filter images by age.

license'Type-Any' | 'L1' | 'L2_L3_L4_L5_L6_L7' | 'L2_L3_L4' | 'L2_L3_L5_L6' | 'L2_L3'

Filter images by license.

output'json' | 'html' | 'md' | 'null' nullable

Response content format. md returns Markdown in data.content with data.format=md; the JSON success/request envelope remains. Accept: text/markdown also selects Markdown unless output or html=true is explicit. html is an alias for html=true and retains the existing Brotli/Base64 source format.

json_restrictorstring nullable

Select fields within data.content for JSON or Markdown. Supports comma-separated paths, non-negative array indices, half-open slices [0:3] (either bound may be omitted), [] and .{nested,subqueries}. Up to128 selections and16 levels. Missing fields are omitted; selected declared fields retain their zero defaults. The request envelope and credit headers remain. Include next_page_token when pagination is needed. Incompatible with HTML output. This changes response presentation only; tracing-enabled history retains the complete JSON result.

no_cacheboolean nullable

Accepted for compatibility. Searches are always fetched without a result cache for either value; normal successful-request billing applies.

Example request

{
  "json_restrictor": "results[].{title,url},has_next_page,next_page_token"
}

Response

Request completed. One credit is charged, including recognized empty or unavailable source results and source inventory changes discovered after a valid continuation is fetched. These completed responses may preserve verified partial results; operational failures remain errors.

successtrue required
request_idstring uuid required

Changes

No recorded changes to this operation across all 2 revisions of this API.