> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bing Search

> Web Scraping API Bing Search Template

The `bing_search` template is built to obtain Bing Search results.

<Note>
  ### Useful Links

  * Set the `headless` parameter to `html` to scrape AI-generated search results from Bing.
  * [**Real-time**](https://help.decodo.com/docs/web-scraping-api-real-time-requests) and [**Asynchronous**](https://help.decodo.com/docs/web-scraping-api-asynchronous-requests) integration methods are available for this template.
  * [**Batch**](https://help.decodo.com/docs/web-scraping-api-asynchronous-requests#queue-multiple-tasks) requests are also supported.
</Note>

## Input Parameters

Request parameters available for Bing Search target:

| Parameter     | Type    | Required | Description                                                                                                                                                                                                                          |
| ------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `target`      | string  | ✅        | Target type must be set to `bing_search`                                                                                                                                                                                             |
| `query`       | string  | ✅        | Search query                                                                                                                                                                                                                         |
| `headless`    | string  |          | `html` value enables JavaScript rendering. [**Read more.**](https://help.decodo.com/docs/web-scraping-api-javascript-rendering)<br />`png` value enables screenshot response. [**Read more.**](web-scraping-api-screenshot-response) |
| `parse`       | boolean |          | Automatically parses results when set to `true`. <br />Default value is `false`.                                                                                                                                                     |
| `geo`         | string  |          | Set the country to use when submitting the query.                                                                                                                                                                                    |
| `locale`      | string  |          | Set the value to change your Bing search page web interface language.                                                                                                                                                                |
| `domain`      | string  |          | Specify top-level domain.                                                                                                                                                                                                            |
| `device_type` | string  |          | Specify device type and browser. [**Read more.**](https://help.decodo.com/docs/web-scraping-api-device-types)                                                                                                                        |
| `page_from`   | string  |          | Customize the starting page number within the range of `1` to `100`. <br />Default value is `1`.                                                                                                                                     |
| `page_count`  | integer |          | Customize the desired page count number within the range of 1 to 10. <br />Each page provides 10 search results. <br />Default value is 1.                                                                                           |
| `xhr`         | boolean |          | Set to `true` to retrieve a list of XHR and fetch requests. [**Read more.**](https://help.decodo.com/docs/web-scraping-api-fetch-and-xhr)<br />Default value is `false`.                                                             |
| `markdown`    | boolean |          | Set to `true` to receive a Markdown response. [**Read more.**](https://help.decodo.com/docs/web-scraping-api-markdown-response)<br />Default value is `false`.                                                                       |

### Request Examples

<CodeGroup>
  ```shellscript cURL theme={null}
  # update 'TOKEN VALUE' with your authorization token
  curl --request 'POST' \
          --url 'https://scraper-api.decodo.com/v2/scrape' \
          --header 'Accept: application/json' \
          --header 'Authorization: Basic TOKEN VALUE' \
          --header 'Content-Type: application/json' \
          --data '
      {
        "target": "bing_search",
        "query": "laptop",
        "page_from": "1",
        "parse": true
      }
  '
  ```

  ```javascript Node theme={null}

  const scrape = async() => {
    const response = await fetch("https://scraper-api.decodo.com/v2/scrape", {
      method: "POST",
      body: JSON.stringify({
        "target": "bing_search",
        "query": "pizza",
        "page_from": "1",
        "limit": "10",
        "parse": true
      }),
      headers: {
        "Content-Type": "application/json",
        "Authorization": "Basic TOKEN VALUE" // update with your authorization token
      },
    }).catch(error => console.log(error));

    console.log(await response.json())
  }

  scrape()
  ```

  ```python Python theme={null}
  import requests
    
  url = "https://scraper-api.decodo.com/v2/scrape"
    
  payload = {
        "target": "bing_search",
        "query": "pizza",
        "page_from": "1",
        "limit": "10",
        "parse": True
  }
    
  headers = {
      "accept": "application/json",
      "content-type": "application/json",
      "authorization": "Basic TOKEN VALUE" # update with your authorization token
  }
    
  response = requests.post(url, json=payload, headers=headers)
    
  print(response.text)
  ```
</CodeGroup>

## Output

Descriptions for fields in the parsed `JSON` `results` section are provided in the table below. Keep in mind that the number of fields can vary according to the provided search query.

| Results key | Description                                                                      |
| ----------- | -------------------------------------------------------------------------------- |
| `url`       | URL to the Bing Search page.                                                     |
| `page`      | The page number.                                                                 |
| `results`   | A dictionary of paid and organic search results with their detailed information. |

#### Response Example

<CodeGroup>
  ```json JSON expandable theme={null}
  {
    "results": [
        {
            "content": {
                "results": {
                    "page": 1,
                    "parse_status_code": 12000,
                    "results": {
                        "organic": [
                            {
                                "desc": "Compre notebook com os melhores preços na Magazine Luiza! Encontre modelos Samsung, Acer e Dell. Aproveite as ofertas exclusivas!",
                                "pos": 1,
                                "pos_overall": 1,
                                "title": "Notebook: Samsung, Acer, Dell, Macbook, Lenovo | Magalu",
                                "url": "https://www.magazineluiza.com.br/notebook/informatica/s/in/note/",
                                "url_shown": "https://www.magazineluiza.com.br ›notebook› informat…"
                            },
                            {
                                "desc": "Os notebooks Dell são sinônimo de resistência e performance. Equipados com processadores de última geração, eles são ideais para quem busca durabilidade sem abrir mão de potência. Com designs modernos e suporte técnico renomado, eles são perfeitos para qualquer ambiente, seja ele profissional ou acadêmico.See more on kabum.com.br",
                                "pos": 2,
                                "pos_overall": 2,
                                "title": "KaBuM!: Notebooks em promoção",
                                "url": "https://www.kabum.com.br/computadores/notebooks",
                                "url_shown": "https://www.kabum.com.br › computadores › notebooks"
                            }
                        ],
                        "paid": [
                            {
                                "desc": "Laptop no Mercado Livre com Frete Grátis a partir de R$79. Veja Condições. Seu produto no Mercado Livre com Preços Incríveis e 12x Sem Juros. Aproveite!",
                                "pos": 1,
                                "pos_overall": 3,
                                "title": "Laptop no Mercado Livre - Melhores Ofertas Mercado Livre",
                                "url": "https://www.bing.com/aclick?ld=e8B6O3AJC25sGV1XGLxBPDLzVUCUza9fwoXap6shgs8VlwORnu1WvIDontPqX7hnzgch7S4_necKydst-aqPBghpRU47RKPZSGcWanQzmmzAcDdX7M7GQ7VwJ022I_hkJ7j8OrgFn0It3TKxQ5TqqoaMC__a3timxw-4BJobVv0O5ydQyKk17unPYA0MUJ5LxcQOtcmoJLOpPiYGWYe2vcd9AIH1c&u=aHR0cHMlM2ElMmYlMmZsaXN0YS5tZXJjYWRvbGl2cmUuY29tLmJyJTJmbGFwdG9wJTNmbWF0dF90b29sJTNkNzA1NTg5ODklMjZtYXR0X3dvcmQlM2RsYXB0b3AlMjZtYXR0X3NvdXJjZSUzZGJpbmclMjZtYXR0X2NhbXBhaWduX2lkJTNkNjM4NjE4OTA5JTI2bWF0dF9hZF9ncm91cF9pZCUzZDEzMjE2MTUzOTIzMDg5ODQlMjZtYXR0X21hdGNoX3R5cGUlM2RlJTI2bWF0dF9uZXR3b3JrJTNkbyUyNm1hdHRfZGV2aWNlJTNkYyUyNm1hdHRfY3JlYXRpdmUlM2QlMjZtYXR0X2tleXdvcmQlM2RsYXB0b3AlMjZtYXR0X2FkX3Bvc2l0aW9uJTNkJTI2bWF0dF9hZF90eXBlJTNkJTI2bWF0dF9tZXJjaGFudF9pZCUzZCUyNm1hdHRfcHJvZHVjdF9pZCUzZCUyNm1hdHRfcHJvZHVjdF9wYXJ0aXRpb25faWQlM2QlMjZtYXR0X3RhcmdldF9pZCUzZGt3ZC04MjYwMjUwNTE0NDI5NyUzYWxvYy0yMCUyNmNxX3NyYyUzZGdvb2dsZV9hZHMlMjZjcV9jbXAlM2Q2Mzg2MTg5MDklMjZjcV9uZXQlM2RvJTI2Y3FfcGx0JTNkZ3AlMjZjcV9tZWQlM2QlMjZtc2Nsa2lkJTNkNTJhZGJlNTVhMzVkMTVlM2U5N2VkN2Q0NjE3MDFmOTglMjZ1dG1fc291cmNlJTNkYmluZyUyNnV0bV9tZWRpdW0lM2RjcGMlMjZ1dG1fY2FtcGFpZ24lM2RNTEJfTUxfQklOR19BT19NTEIxNjQ4LUluZm9ybWF0aWNhX1hfU0VBUkNIX0FMTEJfVFhTX05FVy1Qb3J0YXRlaXMlMjUyMGUlMjUyMEFjZXNzb3Jpb3MlMjZ1dG1fdGVybSUzZGxhcHRvcCUyNnV0bV9jb250ZW50JTNkTDItUG9ydGF0ZWlzJTI1MjBlJTI1MjBBY2Vzc29yaW9zX0wzLU5vdGVib29rc19OQV9OQV9OQV9CUi1FWA&rlid=52adbe55a35d15e3e97ed7d461701f98",
                                "url_shown": "www.mercadolivre.com.br › informatica › notebooks"
                            },
                            {
                                "desc": "Notebook Dell Com Intel® Core™ Ultra e Windows 11. Compre seu Novo Notebook Dell Agora. Compre Hoje com Descontos Exclusivos com Frete Grátis e até 12x Sem Juros",
                                "pos": 2,
                                "pos_overall": 4,
                                "title": "Compre Laptop - Dell - Loja Oficial - Confira nossas Ofertas",
                                "url": "https://www.bing.com/aclick?ld=e8VexcCT2YYQk7N-y_086c6DVUCUx5-iqESu5siAo8Ui13wZxlcBK8bm1DZK3rO6buh3aX3ohM6ABMHIhDy1ZSOsxVfcWnpysGVfc3l_LI9JwNX_nDo3gGhe4huk5yr10Gds2UW-WFHXCEaTHxJhlt4iEFtrUZqjzXUtMnZxqSqlDV_h6zB01oKkh7m7-mOeC4Mo7SJfVOlxo6soOeE9BNHCN57nM&u=aHR0cHMlM2ElMmYlMmZhZC5kb3VibGVjbGljay5uZXQlMmZzZWFyY2hhZHMlMmZsaW5rJTJmY2xpY2slM2ZsaWQlM2Q0MzcwMDA4MDEyMTI2MTk3MSUyNmRzX3Nfa3dnaWQlM2Q1ODcwMDAwODcxNTI0NTEyMiUyNmRzX2FfY2lkJTNkMTIwMTIxOTg5NiUyNmRzX2FfY2FpZCUzZDE5NzgyNTc0OTQzJTI2ZHNfYV9hZ2lkJTNkMTYwODQ4NDIwOTAzJTI2ZHNfYV9saWQlM2Rrd2QtMTExNTI1ODElMjYlMjZkc19lX2FkaWQlM2Q3NzU4NDUwOTQ0OTYzNyUyNmRzX2VfdGFyZ2V0X2lkJTNka3dkLTc3NTg0NjU5MjMwNDcwJTNhbG9jLTIwJTI2JTI2ZHNfZV9uZXR3b3JrJTNkbyUyNmRzX3VybF92JTNkMiUyNmRzX2Rlc3RfdXJsJTNkaHR0cHMlM2ElMmYlMmZkZWFscy5kZWxsLmNvbSUyZnB0LWJyJTNmZ2FjZCUzZDk2NTcxMDUtMTQwNzQtNTc2MzAxNy0zNjE2OTg5NjQtMCUyNmRnYyUzZFNUJTI2U0EzNjBDSUQlM2QxOTc4MjU3NDk0MyUyNmdjbGlkJTNkMjViNTBlNDBjYmI1MTk5ZGE4OTY2N2MxMDk5ODU0YTklMjZnY2xzcmMlM2QzcC5kcyUyNiUyNm1zY2xraWQlM2QyNWI1MGU0MGNiYjUxOTlkYTg5NjY3YzEwOTk4NTRhOSUyNnV0bV9zb3VyY2UlM2RiaW5nJTI2dXRtX21lZGl1bSUzZGNwYyUyNnV0bV9jYW1wYWlnbiUzZEFPX0FPX0JSX1BERUxMX0NWVF9TUkNIX0NTR19DU0ctUEFOLTM0NDQwNDMtUFJPLU1pY3Jvc29mdC1TVE5EJTI1MjBHTlJDLUJyb2FkLUNvbnN1bWVyLVN5c3RlbXMlMjZ1dG1fdGVybSUzZGxhcHRvcCUyNnV0bV9jb250ZW50JTNkQ29yZSUyNTIwTGFwdG9wcw&rlid=25b50e40cbb5199da89667c1099854a9",
                                "url_shown": "www.dell.com"
                            },
                            {
                                "desc": "Use seu cartão e aproveite até 10x sem juros em produtos. KaBuM é o maior e-commerce de tecnologia do Brasil",
                                "pos": 3,
                                "pos_overall": 5,
                                "title": "KaBuM - Loja Virtual - Com Ofertas Imperdíveis",
                                "url": "https://www.bing.com/aclick?ld=e8lWxsDvNoQsPuXJQXPMCcajVUCUxCiipXXe59fVZX1KvDiPrLTuFvektmLNJWOT4_gcug7iELYmoTod8KFJuKC88uZ0E9q_QFmXcOiOAc8W3D34byGdug3CLhDpwezzDxtbOWP2YaS6DeJi997Wg0TD-HbdUZk0QVTdv1kTw6kdZnwPRXTc1HlEqAP4ZgHbL9s49k7Ft_-PNWsRIa-F7DkAgZmJA&u=aHR0cHMlM2ElMmYlMmZ3d3cua2FidW0uY29tLmJyJTJmY29tcHV0YWRvcmVzJTJmbm90ZWJvb2tzJTNmdXRtX2lkJTNkNjA1NzU1NDk0JTI2bXNjbGtpZCUzZGZjNzBlYzhhYThmYTEyNzE2MGRiODUwYjZhZDdhN2FkJTI2dXRtX3NvdXJjZSUzZGJpbmclMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX2NhbXBhaWduJTNkYmluZ19zZWFyY2hfcGVyZm9ybWFuY2VfY29tcHV0YWRvcmVzXzFwJTI2dXRtX3Rlcm0lM2RsYXB0b3AlMjZ1dG1fY29udGVudCUzZG5vdGVib29rcw&rlid=fc70ec8aa8fa127160db850b6ad7a7ad",
                                "url_shown": "www.kabum.com.br › notebooks"
                            }
                        ]
                    },
                    "url": "https://www.bing.com/search?q=laptop"
                },
                "errors": [],
                "status_code": 12000,
                "task_id": "7424385822159286273"
            },
            "headers": {},
            "status_code": 200,
            "query": "laptop",
            "task_id": "7424385822159286273",
            "created_at": "2026-02-03 09:38:38",
            "updated_at": "2026-02-03 09:38:54"
        }
    ]
  }
  ```
</CodeGroup>

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>
