curl --request POST \
--url https://api.cloro.dev/v1/monitor/bing \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "how to remove rust from cast iron",
"country": "US",
"include": {
"aioverview": true
}
}
'import requests
url = "https://api.cloro.dev/v1/monitor/bing"
payload = {
"query": "how to remove rust from cast iron",
"country": "US",
"include": { "aioverview": True }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'how to remove rust from cast iron',
country: 'US',
include: {aioverview: true}
})
};
fetch('https://api.cloro.dev/v1/monitor/bing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cloro.dev/v1/monitor/bing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'how to remove rust from cast iron',
'country' => 'US',
'include' => [
'aioverview' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.cloro.dev/v1/monitor/bing"
payload := strings.NewReader("{\n \"query\": \"how to remove rust from cast iron\",\n \"country\": \"US\",\n \"include\": {\n \"aioverview\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.cloro.dev/v1/monitor/bing")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"how to remove rust from cast iron\",\n \"country\": \"US\",\n \"include\": {\n \"aioverview\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloro.dev/v1/monitor/bing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"how to remove rust from cast iron\",\n \"country\": \"US\",\n \"include\": {\n \"aioverview\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"result": {
"organicResults": [
{
"position": 1,
"title": "How to Clean a Rusty Cast-Iron Skillet - Martha Stewart",
"link": "https://www.marthastewart.com/how-to-clean-rusty-cast-iron-skillet-8408007",
"displayedLink": "https://www.marthastewart.com",
"snippet": "To remove rust, scrub the skillet with steel wool, soak it in a vinegar solution, and re-season it afterward. Prevent rust …",
"page": 1,
"date": "Aug 2, 2026"
}
],
"aioverview": {
"text": "Rust can be safely removed from cast iron using abrasives, vinegar, or salt, followed by thorough drying and re-seasoning to restore its non-stick surface...",
"sources": [
{
"position": 1,
"label": "How Do You Remove Rust from Cast Iron Without Damaging It?",
"url": "https://ironpatina.com/how-to-remove-rust-from-cast-iron-cookware-complete-guide-proven-techniques/",
"description": null
}
],
"citationPills": [
{
"label": "How Do You Remove Rust from Cast Iron Without Damaging It?",
"citationPillId": 1,
"url": "https://ironpatina.com/how-to-remove-rust-from-cast-iron-cookware-complete-guide-proven-techniques/",
"domain": "ironpatina.com",
"position": 1
}
],
"markdown": "## **Rust can be safely removed from cast iron using abrasives, vinegar, or salt..."
},
"html": [
"https://cdn.cloro.dev/results/5d0f3c8e-2b7a-4c1e-9f64-8a3e1b7d2c90/page-1.html"
]
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "prompt",
"message": "Prompt cannot be empty"
}
],
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "MISSING_API_KEY",
"message": "Missing or invalid API key",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "Insufficient credits",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "CONCURRENCY_LIMIT_EXCEEDED",
"message": "Concurrency limit exceeded",
"details": {
"limit": 10
},
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "REQUEST_CANCELED",
"message": "Request was canceled by client",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "Maximum retries exceeded",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}Extract Bing Search
Get the organic results and the AI Overview, Bing’s AI summary, from a Bing results page for a query, by country.
curl --request POST \
--url https://api.cloro.dev/v1/monitor/bing \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "how to remove rust from cast iron",
"country": "US",
"include": {
"aioverview": true
}
}
'import requests
url = "https://api.cloro.dev/v1/monitor/bing"
payload = {
"query": "how to remove rust from cast iron",
"country": "US",
"include": { "aioverview": True }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'how to remove rust from cast iron',
country: 'US',
include: {aioverview: true}
})
};
fetch('https://api.cloro.dev/v1/monitor/bing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cloro.dev/v1/monitor/bing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'how to remove rust from cast iron',
'country' => 'US',
'include' => [
'aioverview' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.cloro.dev/v1/monitor/bing"
payload := strings.NewReader("{\n \"query\": \"how to remove rust from cast iron\",\n \"country\": \"US\",\n \"include\": {\n \"aioverview\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.cloro.dev/v1/monitor/bing")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"how to remove rust from cast iron\",\n \"country\": \"US\",\n \"include\": {\n \"aioverview\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloro.dev/v1/monitor/bing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"how to remove rust from cast iron\",\n \"country\": \"US\",\n \"include\": {\n \"aioverview\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"result": {
"organicResults": [
{
"position": 1,
"title": "How to Clean a Rusty Cast-Iron Skillet - Martha Stewart",
"link": "https://www.marthastewart.com/how-to-clean-rusty-cast-iron-skillet-8408007",
"displayedLink": "https://www.marthastewart.com",
"snippet": "To remove rust, scrub the skillet with steel wool, soak it in a vinegar solution, and re-season it afterward. Prevent rust …",
"page": 1,
"date": "Aug 2, 2026"
}
],
"aioverview": {
"text": "Rust can be safely removed from cast iron using abrasives, vinegar, or salt, followed by thorough drying and re-seasoning to restore its non-stick surface...",
"sources": [
{
"position": 1,
"label": "How Do You Remove Rust from Cast Iron Without Damaging It?",
"url": "https://ironpatina.com/how-to-remove-rust-from-cast-iron-cookware-complete-guide-proven-techniques/",
"description": null
}
],
"citationPills": [
{
"label": "How Do You Remove Rust from Cast Iron Without Damaging It?",
"citationPillId": 1,
"url": "https://ironpatina.com/how-to-remove-rust-from-cast-iron-cookware-complete-guide-proven-techniques/",
"domain": "ironpatina.com",
"position": 1
}
],
"markdown": "## **Rust can be safely removed from cast iron using abrasives, vinegar, or salt..."
},
"html": [
"https://cdn.cloro.dev/results/5d0f3c8e-2b7a-4c1e-9f64-8a3e1b7d2c90/page-1.html"
]
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "prompt",
"message": "Prompt cannot be empty"
}
],
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "MISSING_API_KEY",
"message": "Missing or invalid API key",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "Insufficient credits",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "CONCURRENCY_LIMIT_EXCEEDED",
"message": "Concurrency limit exceeded",
"details": {
"limit": 10
},
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "REQUEST_CANCELED",
"message": "Request was canceled by client",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "Maximum retries exceeded",
"timestamp": "2025-01-15T12:00:00.000Z"
}
}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 Modeprompt. A longer query returns a400with the messageQuery is too long (max 3,500 characters, fewer for non-Latin scripts).country: sets Bing’s market. All countries exceptCN,KRandRU.GET /v1/countries?model=bingreturns the list.include.aioverview:trueor{"markdown": true}. It returnsresult.aioverview, and{"markdown": true}also returnsresult.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.
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:| Field | Description |
|---|---|
result.organicResults | The organic results of the first results page: position, title, link, displayedLink, snippet, page and, when Bing shows one, date. See Google organic results for the fields. link is the destination URL, not Bing’s click-tracking URL |
result.aioverview | Bing’s AI summary: text, sources, citationPills and, with include.aioverview.markdown, markdown. See Google AI Overview for the fields. A source has description: null when Bing shows no snippet for it. Only when include.aioverview is set, and omitted when Bing shows no AI summary |
result.html | An array with a URL to the full page that Bing rendered. Only when include.html is true |
Example
{
"query": "how to remove rust from cast iron",
"country": "US",
"include": {
"aioverview": true,
"html": true
}
}
{
"success": true,
"result": {
"organicResults": [
{
"position": 1,
"title": "How to Clean a Rusty Cast-Iron Skillet - Martha Stewart",
"link": "https://www.marthastewart.com/how-to-clean-rusty-cast-iron-skillet-8408007",
"displayedLink": "https://www.marthastewart.com",
"snippet": "To remove rust, scrub the skillet with steel wool, soak it in a vinegar solution, and re-season it afterward. Prevent rust …",
"page": 1
},
{
"position": 2,
"title": "10 Simple Ways to Remove Rust from Cast Iron - Tips Bulletin",
"link": "https://www.tipsbulletin.com/how-to-remove-rust-from-cast-iron/",
"displayedLink": "https://www.tipsbulletin.com › how-to-remove-rust-from-cast-iron",
"snippet": "Learn 10 simple ways to clean rust from cast iron pans, pots, grills, and stoves. Find out how to prevent rust with …",
"page": 1
},
{
"position": 3,
"title": "How To Clean Rust Off A Cast-Iron Pan - Southern Living",
"link": "https://www.southernliving.com/how-to-clean-rust-off-a-cast-iron-pan-11856490",
"displayedLink": "https://www.southernliving.com",
"snippet": "Key Takeaways Scrub rust with vinegar or baking soda, then wash and dry the pan thoroughly. Re-season the pan …",
"page": 1
}
],
"aioverview": {
"text": "Rust can be safely removed from cast iron using abrasives, vinegar, or salt, followed by thorough drying and re-seasoning to restore its non-stick surface. ...",
"sources": [
{
"label": "How Do You Remove Rust from Cast Iron Without Damaging It?",
"url": "https://ironpatina.com/how-to-remove-rust-from-cast-iron-cookware-complete-guide-proven-techniques/",
"description": null,
"position": 1
},
{
"label": "How to Remove Rust from a Cast Iron Skillet: 11 Steps",
"url": "https://www.wikihow.com/Remove-Rust-from-a-Cast-Iron-Skillet",
"description": null,
"position": 2
},
{
"label": "How to Remove Rust from Cast Iron - Bob Vila",
"url": "https://www.bobvila.com/articles/how-to-remove-rust-from-cast-iron/",
"description": null,
"position": 3
}
],
"citationPills": [
{
"label": "How Do You Remove Rust from Cast Iron Without Damaging It?",
"citationPillId": 1,
"url": "https://ironpatina.com/how-to-remove-rust-from-cast-iron-cookware-complete-guide-proven-techniques/",
"domain": "ironpatina.com",
"position": 1
},
{
"label": "How to Remove Rust from a Cast Iron Skillet: 11 Steps",
"citationPillId": 1,
"url": "https://www.wikihow.com/Remove-Rust-from-a-Cast-Iron-Skillet",
"domain": "wikihow.com",
"position": 2
},
{
"label": "How to Remove Rust from Cast Iron - Bob Vila",
"citationPillId": 1,
"url": "https://www.bobvila.com/articles/how-to-remove-rust-from-cast-iron/",
"domain": "bobvila.com",
"position": 3
}
]
},
"html": [
"https://cdn.cloro.dev/results/5d0f3c8e-2b7a-4c1e-9f64-8a3e1b7d2c90/page-1.html"
]
}
}
ironpatina.com +2, so its three sources share citationPillId: 1.Authorizations
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
Request parameters for monitoring Bing search results
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)".
1 - 3500"how to remove rust from cast iron"
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.
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 "US"
Was this page helpful?