---
title: "Suggest Bing search queries"
method: GET
path: "/bing/suggest"
tags: ["Bing"]
---

# Suggest Bing search queries

`GET /bing/suggest`

## Request

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

Returns Bing autosuggest query completions for a query prefix. Locale defaults to country=us and lang=en-us. Suggestions are fetched from public Bing suggest endpoints and trimmed to the requested count. `rich=true` adds entity cards (name, description, image) where Bing shows them.

## Query parameters

- `q` string, required
- `count` integer
- `country` string
- `lang` string
- `rich` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BingSuggestResponseDoc
  - `code` integer
  - `data` BingSuggestResponse
    - `query` string: Query prefix the suggestions were requested for.
    - `suggestions` BingSuggestionResult[]: Search suggestions Bing returned, in order.
      - `entity` BingSuggestionEntity
        - `description` string: Short description of the entity.
        - `image_url` string: URL of the entity's image.
        - `name` string: Name of the entity.
      - `position` integer: Rank of the suggestion in the list, starting at 1.
      - `query` string: Suggested search query.
  - `msg` string

## Other responses

- `400`: Missing or invalid query parameters
- `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)