Get Bing suggestions

Get the autocomplete suggestions Bing shows for a keyword, in one of ten markets, as a JSON list.

GEThttps://rankfield.dev/v1/bing/suggest?query={keyword}

curl 'https://rankfield.dev/v1/bing/suggest?query=keyword%20research&market=en-US' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

response = requests.get(
    "https://rankfield.dev/v1/bing/suggest?query=keyword%20research&market=en-US",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())

const response = await fetch("https://rankfield.dev/v1/bing/suggest?query=keyword%20research&market=en-US", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
  },
});
console.log(await response.json());

{
  "source": "bing-suggest",
  "query": "keyword research",
  "market": "en-US",
  "count": 17,
  "suggestions": [
    "keyword research",
    "keyword research tool",
    "keyword research tool free",
    "keyword research tips",
    "keyword research report",
    "keyword research tools seo",
    "keyword research software",
    "keyword research free",
    "keyword research for seo",
    "keyword research google",
    "keyword research and analysis",
    "keyword research seo tool",
    "keyword researcher",
    "keyword research tools for aeo in llms",
    "keyword research planner",
    "keyword research tool google",
    "keyword research meaning"
  ]
}

{
  "error": "A valid API key is required"
}

One keyword per request, answered at once. For keyword lists, start a job.

Parameters

Headers

Name	Type	Required	Default	Description
`Authorization`	string	Yes	–	`Bearer` followed by your API key. See Authentication.

Query parameters

Name	Type	Required	Default	Description
`query`	string	Yes	–	The keyword, 1–200 printable characters. URL-encode it.
`market`	string	No	`en-US`	One of `en-US`, `en-GB`, `en-CA`, `en-AU`, `en-IN`, `en-NG`, `fr-FR`, `de-DE`, `es-ES`, `pt-BR`.
`freshness`	string	No	`fresh`	`fresh` may reuse an answer stored in the last 5 minutes (30 seconds if the list was empty); otherwise it asks the engine. `allow-stale` may also return an answer up to 35 minutes old, marked with a `Warning: 110 - "Response is stale"` header, and refreshes it in the background.

Response

Field	Type	Description
`source`	string	`bing-suggest`.
`query`	string	The keyword as it was sent to the engine.
`market`	string	The market used.
`count`	integer	How many entries `suggestions` holds.
`suggestions`	string[]	The engine's list, in its order.

The count varies by keyword and market. Suggestions are what the engine shows while someone types. They are not search volumes.

Errors

Status	When
400	`query` is missing, empty, over 200 characters, or another parameter is invalid.
401	No valid API key.
429	The engine is busy: its collection budget is full for the moment. Wait for `Retry-After`.
502	Bing answered with an error, or with data that couldn't be read.
503	Bing collection is paused, cooling down, timed out or unavailable. Retry after `Retry-After`.

Limits

No per-key limits for now. When an engine is busy it answers 429, or 503 while it cools down, with Retry-After. Get usage and capacity shows what your key has used.

MCP

On the MCP server, the tool for this is get_bing_suggestions.

Get Bing suggestions

#Parameters

#Headers

#Query parameters

#Response

#Errors

#Limits

#MCP