---
title: "Search Bing image results"
method: GET
path: "/bing/images"
tags: ["Bing"]
---

# Search Bing image results

`GET /bing/images`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/bing/images`
- Auth: API key in header `x-api-key`

Returns Bing image search results for a query string. Locale defaults to country=us and lang=en-us. Returns 503 when Bing serves a challenge page or unusable results.

## Query parameters

- `q` string, required
- `page` integer
- `count` integer
- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BingImagesResponseDoc
  - `code` integer
  - `data` BingImagesResponse
    - `pagination` BingSearchPagination
      - `count` integer: Number of results requested per page.
      - `next_page` integer: Page number of the next page. Omitted when there is no next page.
      - `page` integer: Page number of this response, starting at 1.
      - `previous_page` integer: Page number of the previous page. Omitted on the first page.
    - `results` BingImageResult[]: Image results in Bing's order.
      - `height` integer: Image height as Bing reports it.
      - `image_url` string: URL of the full-size image.
      - `position` integer: Rank of the image across all result pages, starting at 1.
      - `source` string: Site the image comes from, for example `example.com`.
      - `source_url` string: URL of the page that hosts the image.
      - `thumbnail` string: URL of the image thumbnail served by Bing.
      - `title` string: Image title as shown on the Bing results page.
      - `url` string: URL Bing links the image result to.
      - `width` integer: Image width as Bing reports it.
  - `msg` string

## Other responses

- `400`: Missing or invalid query parameters
- `404`: No results found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: Bing upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)