Skip to main content
POST
Monitor Bing Search Results
Extract the organic results and the AI Overview from a Bing results page (bing.com/search). The AI Overview is Bing’s AI summary at the top of the results page. The fields have the same names and shapes as the Google Search fields. This endpoint is not Bing AI Mode. Bing AI Mode returns the AI answer page at bing.com/copilotsearch for a prompt. Bing Search returns the results page for a query.

Request parameters

query and country are required. The include flags are optional. There is no state, location, device or pages.
  • query: Bing puts the query in the page URL, so the limit is 3,500 characters after URL encoding. This is the same limit as the Bing AI Mode prompt. A longer query returns a 400 with the message Query is too long (max 3,500 characters, fewer for non-Latin scripts).
  • country: sets Bing’s market. All countries except CN, KR and RU. GET /v1/countries?model=bing returns the list.
  • include.aioverview: true or {"markdown": true}. It returns result.aioverview, and {"markdown": true} also returns result.aioverview.markdown. It adds +2 credits, as on Google Search. The add-on is charged also when Bing shows no AI summary.
  • include.html: returns a URL to the results page that Bing rendered.
For async requests, send the same body as payload with taskType: "BING" to POST /v1/async/task or POST /v1/async/task/batch.

Response schema

Includes the common response fields plus these fields:

Example

Request
Response
The chip in this example shows ironpatina.com +2, so its three sources share citationPillId: 1.

Authorizations

Authorization
string
header
required

cloro API key as a bearer token. One key grants every endpoint in this spec; per-key scopes are not available, so a client cannot request a narrower permission. Keys are created and revoked in the dashboard.

Body

application/json

Request parameters for monitoring Bing search results

query
string
required

The search query. Bing puts the query in the page URL, so the limit is 3,500 characters after URL encoding. A letter, digit or space counts as 1, most punctuation as 3, an accented or Cyrillic letter as 6, and a Chinese, Japanese or Korean character as 9. A longer query returns a 400 error: "Query is too long (max 3,500 characters, fewer for non-Latin scripts)".

Required string length: 1 - 3500
Example:

"how to remove rust from cast iron"

country
enum<string>
required

Country/region code, using ISO 3166-1 alpha-2 country codes. The country sets Bing's market. Bing Search accepts all countries except CN, KR and RU. GET /v1/countries?model=bing returns the list.

Available options:
AD,
AE,
AF,
AG,
AI,
AL,
AM,
AO,
AQ,
AR,
AS,
AT,
AU,
AW,
AX,
AZ,
BA,
BB,
BD,
BE,
BF,
BG,
BH,
BI,
BJ,
BL,
BM,
BN,
BO,
BQ,
BR,
BS,
BT,
BV,
BW,
BY,
BZ,
CA,
CC,
CD,
CF,
CG,
CH,
CI,
CK,
CL,
CM,
CN,
CO,
CR,
CU,
CV,
CW,
CX,
CY,
CZ,
DE,
DJ,
DK,
DM,
DO,
DZ,
EC,
EE,
EG,
EH,
ER,
ES,
ET,
FI,
FJ,
FK,
FM,
FO,
FR,
GA,
GB,
GD,
GE,
GF,
GG,
GH,
GI,
GL,
GM,
GN,
GP,
GQ,
GR,
GS,
GT,
GU,
GW,
GY,
HK,
HM,
HN,
HR,
HT,
HU,
ID,
IE,
IL,
IM,
IN,
IO,
IQ,
IR,
IS,
IT,
JE,
JM,
JO,
JP,
KE,
KG,
KH,
KI,
KM,
KN,
KP,
KR,
KW,
KY,
KZ,
LA,
LB,
LC,
LI,
LK,
LR,
LS,
LT,
LU,
LV,
LY,
MA,
MC,
MD,
ME,
MF,
MG,
MH,
MK,
ML,
MM,
MN,
MO,
MP,
MQ,
MR,
MS,
MT,
MU,
MV,
MW,
MX,
MY,
MZ,
NA,
NC,
NE,
NF,
NG,
NI,
NL,
NO,
NP,
NR,
NU,
NZ,
OM,
PA,
PE,
PF,
PG,
PH,
PK,
PL,
PM,
PN,
PR,
PS,
PT,
PW,
PY,
QA,
RE,
RO,
RS,
RU,
RW,
SA,
SB,
SC,
SD,
SE,
SG,
SH,
SI,
SJ,
SK,
SL,
SM,
SN,
SO,
SR,
SS,
ST,
SV,
SX,
SY,
SZ,
TC,
TD,
TF,
TG,
TH,
TJ,
TK,
TL,
TM,
TN,
TO,
TR,
TT,
TV,
TW,
TZ,
UA,
UG,
UM,
US,
UY,
UZ,
VA,
VC,
VE,
VG,
VI,
VN,
VU,
WF,
WS,
XK,
YE,
YT,
ZA,
ZM,
ZW
Example:

"US"

include
object

Optional flags for including additional response data

Response

successful Bing Search monitoring response

success
boolean
required
Example:

true

result
object
required

Bing search results data