> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_bing

# search_bing

> Bing's organic results for a keyword in a market: position, title, link and snippet. Ten per call. ₹0.29 per call; a result that finds nothing is ₹0.

## What it does

Bing's organic results for a keyword in a market: data.items[] with the position, title, url, snippet and the result type, ten per call, for the location_name ("India") and language_name ("English") you give, on desktop or mobile.

Use it as the second opinion next to [`search_web`](https://parel.si/docs/tools/search_web.md) (Google's ranking) when a client cares about Bing, or to check a site's Bing position with the same keyword [`rank_check`](https://parel.si/docs/tools/rank_check.md) uses for Google; for pages by meaning use [`search_semantic`](https://parel.si/docs/tools/search_semantic.md). Flat price per call for ten results; a query Bing has no results for is free. Slow: ten to forty seconds in the live check, so the timeout is ninety seconds.

India: location_name "India" and language_name "English" or "Hindi".

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `depth` | integer | no | How many results, up to 10. Default 10.; max 10 |
| `device` | string | no | desktop (default) or mobile. |
| `keyword` | string | one of | The search query, up to 700 characters. |
| `language_name` | string | no | The language by name ("English", "Hindi"). |
| `location_name` | string | no | The market by name ("India", "United States"). |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `keyword`.

## What drives the cost

Flat per call for up to ten results; depth above 10 is refused as invalid_input (free). No results is free. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 90 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.29** per call (`cost_paise: 29`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.44 (`hold_paise: 44`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 90 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_bing"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_bing"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_bing","input":{"depth":10,"keyword":"best protein bar india","language_name":"English","location_name":"India"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "keyword": "best protein bar india",
  "type": "organic",
  "se_domain": "bing.com",
  "location_code": 2356,
  "language_code": "en",
  "check_url": "https://www.bing.com/search?q=best+protein+bar+india&form=QBLH&cc=in",
  "datetime": "2026-11-05 14:10:01 +00:00",
  "spell": null,
  "refinement_chips": null,
  "item_types": [
    "organic"
  ],
  "se_results_count": 0,
  "pages_count": 1,
  "items_count": 10,
  "items": [
    {
      "type": "organic",
      "rank_group": 1,
      "rank_absolute": 1,
      "page": 1,
      "position": "left",
      "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[1]",
      "domain": "www.chennaisuperkings.com",
      "title": "Chennai Super Kings",
      "url": "https://www.chennaisuperkings.com/",
      "cache_url": null,
      "related_search_url": null,
      "breadcrumb": "https://www.chennaisuperkings.com",
      "website_name": "chennaisuperkings.com",
      "is_image": false,
      "is_video": false,
      "is_featured_snippet": false,
      "is_malicious": false,
      "is_web_story": false,
      "checks": null,
      "description": "1 day ago · This is the official page of Chennai Super Kings, an Indian Premier League franchise cricket team based in Chennai. The …",
      "pre_snippet": "1 day ago",
      "extended_snippet": null,
      "images": null,
      "amp_version": false,
      "rating": null,
      "price": null,
      "highlighted": null,
      "links": null,
      "faq": null,
      "extended_people_also_search": null,
      "about_this_result": null,
      "related_result": null,
      "timestamp": null,
      "rectangle": null
    },
    {
      "type": "organic",
      "rank_group": 2,
      "rank_absolute": 2,
      "page": 1,
      "position": "left",
      "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[2]",
      "domain": "www.chennaisuperkings.com",
      "title": "News - Chennai Super Kings",
      "url": "https://www.chennaisuperkings.com/news",
      "cache_url": "https://cc.bingj.com/cache.aspx?q=best%20protein%20bar%20india&d=4530276394625080&mkt=en-US&setlang=en&w=g_j1UoBMem4MIa2Y8cv_RzBuA9IYCbs1",
      "related_search_url": null,
      "breadcrumb": "https://www.chennaisuperkings.com › news",
      "website_name": "chennaisuperkings.com",
      "is_image": false,
      "is_video": false,
      "is_featured_snippet": false,
      "is_malicious": false,
      "is_web_story": false,
      "checks": null,
      "description": "Oct 27, 2026 · Stay updated with the latest news and updates about Chennai Super Kings, an Indian Premier League cricket team …",
      "pre_snippet": "Oct 27, 2026",
      "extended_snippet": null,
      "images": null,
      "amp_version": false,
      "rating": null,
      "price": null,
      "highlighted": null,
      "links": null,
      "faq": null,
      "extended_people_also_search": null,
      "about_this_result": null,
      "related_result": null,
      "timestamp": null,
      "rectangle": null
    },
    {
      "type": "organic",
      "rank_group": 3,
      "rank_absolute": 3,
      "page": 1,
      "position": "left",
      "xpath": "/html[1]/body[1]/div[1]/main[1]/ol[1]/li[3]",
      "domain": "uatapp.chennaisuperkings.com",
      "title": "News - Chennai Super Kings",
      "url": "https://uatapp.chennaisuperkings.com/news",
      "cache_url": null,
      "related_search_url": null,
      "breadcrumb": "https://uatapp.chennaisuperkings.com › news",
      "website_name": "chennaisuperkings.com",
      "is_image": false,
      "is_video": false,
      "is_featured_snippet": false,
      "is_malicious": false,
      "is_web_story": false,
      "checks": null,
      "description": "This is the official page of Chennai Super Kings, an Indian Premier League franchise cricket team based in Chennai. The CSK team …",
      "pre_snippet": null,
      "extended_snippet": null,
      "images": null,
      "amp_version": false,
      "rating": null,
      "price": null,
      "highlighted": null,
      "links": null,
      "faq": null,
      "extended_people_also_search": null,
      "about_this_result": null,
      "related_result": null,
      "timestamp": null,
      "rectangle": null
    }
  ]
}
```

## Notes

- Flat per call for up to ten results; depth above 10 is refused as invalid_input (free). No results is free.
- Give the market and language by name (India, English); the live check found the numeric codes answered no results on Bing.
- Slow: ten to forty seconds; the timeout is ninety seconds.

## Siblings

- [`search_web`](https://parel.si/docs/tools/search_web.md)
- [`rank_check`](https://parel.si/docs/tools/rank_check.md)
- [`search_semantic`](https://parel.si/docs/tools/search_semantic.md)
