> For the complete documentation index, see [llms.txt](https://docs.serphouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.serphouse.com/bing-apis/bing-news-api.md).

# Bing News API

Access real-time Bing News search results and stay informed with the latest news articles, headlines, and trending stories from trusted sources across the web.

{% hint style="danger" %}
Requires authentication
{% endhint %}

<mark style="color:green;">`POST`</mark> `https://api.serphouse.com/bing-news`

#### Path Parameters

| Name         | Type   | Description                          |
| ------------ | ------ | ------------------------------------ |
| responseType | String | responseType can be 'html' or 'json' |

#### Headers

| Name                                            | Type   | Description              |
| ----------------------------------------------- | ------ | ------------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer \<YOUR\_API\_KEY> |
| Content-Type<mark style="color:red;">\*</mark>  | String | application/json         |

#### Request Body

<table><thead><tr><th>Name</th><th>Type</th><th width="222">Description</th></tr></thead><tbody><tr><td>q<mark style="color:red;">*</mark></td><td>string</td><td>Search phrase that you want to search</td></tr><tr><td>lang<mark style="color:red;">*</mark></td><td>string</td><td>You can set language for e.g. <code>en-IN</code> for english <code>fr-FR</code> for french.<br>Get the list of available languages by making a separate request to the <a href="/pages/T3o6bzC5LzinD9qIGamk">List of Language</a></td></tr><tr><td>device<mark style="color:red;">*</mark></td><td>string</td><td>Device can be <code>desktop</code> To extract desktop result <code>mobile</code> To extract mobile result</td></tr><tr><td>loc<mark style="color:red;">*</mark></td><td>string</td><td>Optional field if you specify <code>loc_id</code><br><strong>You must choose one of the fields: <code>loc_id</code> or <code>loc</code></strong><br>You can receive the list of available locations of search engines with their loc_id by making a separate request to the  <a href="/pages/jHif4hVWEf1ax1cYtvip">List of Locations</a></td></tr><tr><td>loc_id<mark style="color:red;">*</mark></td><td>integer</td><td>Optional field if you specify <code>loc</code><br><strong>you must choose one of the fields: <code>loc_id</code> or <code>loc</code></strong><br>You can receive the list of available locations of search engines with their loc_id by making a separate request to the<br><a href="/pages/jHif4hVWEf1ax1cYtvip">List of Locations</a> </td></tr><tr><td>page</td><td>integer</td><td>Give specific page to get the result of that page number. By default it will get you first page.</td></tr><tr><td>no_trace</td><td>string | integer</td><td>Enterprise only. Enables NoTrace mode. Accepted values: <code>0</code>, <code>1</code>, <code>true</code>, and <code>false</code>. When enabled (<code>1</code> or <code>true</code>), search parameters, files, and metadata are not stored on our servers.</td></tr></tbody></table>

{% tabs %}
{% tab title="200: OK" %}

```json
{
    "status": "error",
    "msg": "Please try again",
    "error": ""
}
```

{% endtab %}

{% tab title="200: OK" %}

```json
{
    "status": "success",
    "msg": "Completed",
    "results": {
        "search_metadata": {
            "id": 245699099,
            "status": "success",
            "created_at": "2026-06-17T08:52:51.000000Z",
            "processed_at": "2026-06-17 08:52:51"
        },
        "search_parameters": {
            "domain": "bing.com",
            "lang": "en-IN",
            "country": "IN",
            "location": "Surat,Gujarat,India",
            "q": "today top news",
            "device": "desktop",
            "url": "https://www.bing.com/news/search?q=today+top+news&form=QBLH&cc=IN&setlang=en-IN&count=100",
            "page": "1",
            "num": 10,
            "ie": "UTF-8",
            "tbm": "nws"
        },
        "results": {
            "news": [
                {
                    "position": 1,
                    "img": "https://www.bing.com//th.bing.com/th?id=ONUT.0DtcLoFya0e8QJlbnx8fbA&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://indianexpress.com/article/india/breaking-news-today-latest-news-live-updates-june-15-10740531/",
                    "title": "India News Highlights | Breaking News Today, June 15, 2026 | Top Headlines, Latest News — The Indian Express Realtime",
                    "channel": "The Indian Express",
                    "time": "14h",
                    "snippet": "Follow Indian Express for breaking news today, latest India news live updates, top headlines, politics, business, and world ..."
                },
                {
                    "position": 2,
                    "img": "https://www.bing.com//th.bing.com/th?id=ORMS.41a31a6434a00fbfa52c760f3ce60ce2&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://www.msn.com/en-in/autos/photos/top-10-abp-live-afternoon-bulletin-top-news-headlines-from-17-june-2026-afternoon/ar-AA25QjR1?ocid=BingNewsVerp",
                    "title": "Top 10 | ABP LIVE Afternoon Bulletin: Top News Headlines from 17 June 2026 - Afternoon",
                    "channel": "ABP News on MSN",
                    "time": "8m",
                    "snippet": "ABP News bring you the top 10 headlines at 3 pm. Stay on top of the most important news updates from India and around the ..."
                },
                {
                    "position": 3,
                    "img": "https://www.bing.com//th.bing.com/th?id=ORMS.41a31a6434a00fbfa52c760f3ce60ce2&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://www.msn.com/en-in/autos/photos/top-10-abp-live-morning-bulletin-top-news-headlines-from-16-june-2026-to-start-your-day-morning/ar-AA25JAvx?ocid=BingNewsVerp",
                    "title": "Top 10 | ABP LIVE Morning Bulletin: Top News Headlines from 16 June 2026 to Start Your Day - Morning",
                    "channel": "ABP News on MSN",
                    "time": "19h",
                    "snippet": "ABP News bring you the top 10 headlines to kick start your day and stay on top of the most important news updates from India ..."
                },
                {
                    "position": 4,
                    "img": "https://www.bing.com//th.bing.com/th?id=ONUT.drYoIlQ5pxu1WYMGoVbymg&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://economictimes.indiatimes.com/markets/stocks/live-blog/bse-sensex-today-nifty50-stock-market-live-updates-gift-nifty-prime-focus-groww-share-price-17-june-2026/liveblog/131784287.cms",
                    "title": "Sensex Today | Nifty 50 | Stock Market Live Updates: Sensex gains over 200 pts, Nifty above 24,050; PSU Bank, consumer durables stocks rally",
                    "channel": "The Economic Times",
                    "time": "21m",
                    "snippet": "Indian markets extended gains for a fourth session, with Sensex and Nifty supported by a sharp fall in crude oil prices and ..."
                },
                {
                    "position": 5,
                    "img": "https://www.bing.com//th.bing.com/th?id=ONUT.sJ1zg35EyHsi-3AixD8zMg&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://www.msn.com/en-in/news/India/sc-refuses-relief-to-meenakshi-natarajan-in-rs-nomination-case-cant-make-exception-for-one-candidate/ar-AA25s2fw?ocid=BingNewsVerp",
                    "title": "SC Refuses Relief To Meenakshi Natarajan In RS Nomination Case: ‘Can't Make Exception For One Candidate’",
                    "channel": "on MSN",
                    "time": "5d",
                    "snippet": "The Supreme Court on Friday declined to grant relief to Congress leader Meenakshi Natarajan in connection with the rejection ..."
                },
                {
                    "position": 6,
                    "img": "https://www.bing.com//th.bing.com/th?id=ONUT.__-_HGpl9bQyYdlcZLoCOw&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://www.livemint.com/news/world/usiran-news-live-updates-trump-strait-of-hormuz-g7-summit-israel-netanyahu-nuclear-power-lebanon-11781607503857.html",
                    "title": "US-Iran News LIVE Updates: Trump to release full Iran deal text within days",
                    "channel": "Mint",
                    "time": "4h",
                    "snippet": "US President Donald Trump says full US-Iran agreement text will be released publicly “in a couple of days” Trump hints at ..."
                },
                {
                    "position": 7,
                    "img": null,
                    "url": "https://www.thehindubusinessline.com/multimedia/audio/bl-morning-report-may-18-2026/article71105474.ece",
                    "title": "Top Business &amp; Market Headlines Today — BL Morning Report, June 16, 2026",
                    "channel": "The Hindu BusinessLine",
                    "time": "1d",
                    "snippet": "Stay updated with today’s key global and India economic developments. This update covers a potential US–Iran peace deal that could ease oil supply concerns, India’s export growth alongside a widening ..."
                },
                {
                    "position": 8,
                    "img": null,
                    "url": "https://www.timesnownews.com/city/breaking-news-today-city-news-live-updates-delhi-mumbai-kolkata-chennai-bengaluru-hyderabad-pune-weather-forecast-lpg-crisis-petrol-price-crime-traffic-latest-news-liveblog-154625914",
                    "title": "Noida News LIVE: Akasa Air Launches Operations From Noida International Airport",
                    "channel": "Times Now",
                    "time": "16h",
                    "snippet": "Stay updated with the latest breaking news, traffic alerts, and major developments from India’s top cities - Mumbai, Delhi, Bengaluru, Chennai, and Kolkata - only on Times Now., City News, Times Now ..."
                },
                {
                    "position": 9,
                    "img": null,
                    "url": "https://www.thehindubusinessline.com/multimedia/audio/bl-morning-report-may-14-2026/article70974693.ece",
                    "title": "Top Business &amp; Market Headlines Today — BL Morning Report, May 14, 2026",
                    "channel": "The Hindu BusinessLine",
                    "time": "1mon",
                    "snippet": "Stay updated with today’s key business, energy, and aviation developments. This episode covers higher import duties on gold, silver, and platinum to conserve foreign exchange, a ₹37,500-crore ..."
                },
                {
                    "position": 10,
                    "img": "https://www.bing.com/th?id=ONUT.nkt-xa7VnbYUXjUnCpOXrQ&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://timesofindia.indiatimes.com/business/india-business/sensex-stock-market-today-16-june-2026-live-updates-nse-bse-gift-nifty-50-top-gainers-losers-mcx-stocks-in-focus-market-news/liveblog/131757635.cms",
                    "title": "Stock Market Highlights Today: BSE Sensex ends over 500 points up, Nifty50 shy of 24,000; Asian stocks edge up, oil prices rise marginally",
                    "channel": "The Times of India",
                    "time": "19h",
                    "snippet": "BSE Sensex, Nifty50 saw another string rally on Tuesday after two sessions of rally on US-Iran peace deal hopes. Crude ..."
                },
                {
                    "position": 11,
                    "img": "https://www.bing.com/th?id=ONUT.GW-UFOQD_0p18cbojF78iA&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://www.msn.com/en-in/money/markets/stock-market-today-which-are-top-10-gainers-and-losers-on-nse-bse-on-june-16-check-list/ar-AA25Nexm?ocid=BingNewsVerp",
                    "title": "Stock market today: Which are top 10 gainers and losers on NSE &amp; BSE on June 16? Check list",
                    "channel": "on MSN",
                    "time": "18h",
                    "snippet": "Indian equities surged for a third day, with Sensex and Nifty climbing on positive global cues, foreign investment, and ..."
                },
                {
                    "position": 12,
                    "img": "https://www.bing.com/th?id=ONUT.2eotBP9BLbNCYEnH2H0TMg&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://timesofindia.indiatimes.com/business/india-business/sensex-stock-market-today-17-june-2026-live-updates-nse-bse-gift-nifty-50-top-gainers-losers-mcx-stocks-in-focus-market-news/liveblog/131784445.cms",
                    "title": "Stock Market Live Updates Today: BSE Sensex adds 300 points, Nifty50 remains above 24,000; Asian shares slip, oil prices below $80",
                    "channel": "The Times of India",
                    "time": "6h",
                    "snippet": "Nifty50 and BSE Sensex are likely to open in green as global crude oil prices continue to fall. Market experts expec ..."
                },
                {
                    "position": 13,
                    "img": null,
                    "url": "https://www.analyticsinsight.net/tech-news/top-news-today-samsungs-chip-plans-bitcoin-buzz-rbi-results-ai-growth-more",
                    "title": "Top News Today: Samsung’s Chip Plans, Bitcoin Buzz, RBI Results, AI Growth &amp; More",
                    "channel": "Analytics Insight",
                    "time": "1d",
                    "snippet": "Good Morning, Digital Minds!&nbsp;Here’s your quick scan of today’s biggest developments across technology, startups, crypto, careers, and artificial intelligen ..."
                },
                {
                    "position": 14,
                    "img": "https://www.bing.com/th?id=ONUT.TK0j8nWkPCAO6zWnm-qV7Q&amp;pid=News&amp;w=234&amp;h=132&amp;c=14&amp;rs=2&amp;qlt=90",
                    "url": "https://www.timesnownews.com/education/school-assembly-news-headlines-today-may-13-top-national-international-sports-updates-thought-of-the-day-cbse-result-article-154306255",
                    "title": "School Assembly News Headlines Today (May 13): Top National, International &amp; Sports Updates + Thought of the Day",
                    "channel": "Times Now",
                    "time": "1mon",
                    "snippet": "Take a look at the major national, international, and sports highlights of the day. You may use it in the school assembly on."
                }
            ]
        }
    }
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
    "status": "error",
    "msg": "validation_error",
    "error": {
        "q": [
            "The q field is required."
        ]
    }
}
```

{% endtab %}

{% tab title="402: Payment Required" %}

```json
{
    "status": "error",
    "msg": "Your SERPHouse account has either run out of available credits (try upgrading your Plan), or there is a payment problem.",
    "error": ""
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
    "status": "error",
    "msg": "Missing required fields.",
    "error": ""
}
```

{% endtab %}

{% tab title="401: Unauthorized" %}

```json
{
    "status": "error",
    "msg": "Unauthenticated"
}
```

{% endtab %}
{% endtabs %}

## Example request:

{% tabs %}
{% tab title="BASH" %}

<pre class="language-bash"><code class="lang-bash">curl --location --request <a data-footnote-ref href="#user-content-fn-1">POST </a>'https://api.serphouse.com/bing-news' \
--header 'Authorization: Bearer &#x3C;YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "q": "today top news",
        "lang": "en-IN", 
        "device": "desktop",
        "loc": "Surat,Gujarat,India"
    }
}'
</code></pre>

{% endtab %}

{% tab title="RUBY" %}

```ruby
require "uri"
require "json"
require "net/http"

url = URI("https://api.serphouse.com/bing-news")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer <YOUR_API_KEY>"
request.body = JSON.dump({
  "data": {
    "q": "today top news",
    "lang": "en-IN",
    "device": "desktop",
    "loc": "Surat,Gujarat,India"
  }
})

response = https.request(request)
puts response.read_body
```

{% endtab %}

{% tab title="PYTHON" %}

```python
import requests
import json

url = "https://api.serphouse.com/bing-news"

payload = json.dumps({
  "data": {
    "q": "today top news",
    "lang": "en-IN",
    "device": "desktop",
    "loc": "Surat,Gujarat,India"
  }
})
headers = {
  'Authorization': 'Bearer <YOUR_API_KEY>',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}

{% tab title="NODE.JS" %}

```javascript
var axios = require('axios');
var data = JSON.stringify({
  "data": {
    "q": "today top news",
    "lang": "en-IN",
    "device": "desktop",
    "loc": "Surat,Gujarat,India"
  }
});

var config = {
  method: 'post',
  url: 'https://api.serphouse.com/bing-news',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer <YOUR_API_KEY>'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

```

{% endtab %}

{% tab title="JAVA" %}

```java

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");

JSONObject jsonObject = new JSONObject();
JSONObject dataObject = new JSONObject();
dataObject.put("q", "today top news");
dataObject.put("lang", "en-IN");
dataObject.put("device", "desktop");
dataObject.put("loc", "Surat,Gujarat,India");
jsonObject.put("data", dataObject);

String bodyJson = jsonObject.toString();
RequestBody body = RequestBody.create(mediaType,bodyJson);

Request request = new Request.Builder()
        .url("https://api.serphouse.com/bing-news")
        .method("POST", body)
        .addHeader("Content-Type", "application/json")
        .addHeader("Authorization", "Bearer <YOUR_API_KEY>")
        .build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());git
```

{% endtab %}

{% tab title="JAVASCRIPT" %}

```javascript
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <YOUR_API_KEY>");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "data": {
    "q": "today top news",
    "lang": "en-IN",
    "device": "desktop",
    "loc": "Surat,Gujarat,India"
  }
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://api.serphouse.com/bing-news", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
```

{% endtab %}

{% tab title="GO" %}

```go
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.serphouse.com/bing-news"
  method := "POST"

  payload := strings.NewReader(`{
    "data": {
        "q": "today top news",
        "lang": "en-IN",
        "device": "desktop", 
        "loc": "Surat,Gujarat,India"
    }
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

{% endtab %}

{% tab title="C#/.NET" %}

```csharp
var client = new RestClient("https://api.serphouse.com/bing-news");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer <YOUR_API_KEY>");
var body = @"{
	""data"": {
			""q"": ""today top news"",
			""lang"": ""en-IN"",
			""device"": ""desktop"",
			""loc"": ""Surat,Gujarat,India""
	 }
}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```

{% endtab %}
{% endtabs %}

[^1]:
