---
title: "The News Category API lets you search on Bing and get back a list of top news articles by category. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them.  For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web)."
method: GET
path: "/news"
tags: ["NewsCategory"]
---

# The News Category API lets you search on Bing and get back a list of top news articles by category. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them.  For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

`GET /news`

## Query parameters

- `cc` string
- `category` string
- `count` integer
- `headlineCount` integer
- `mkt` string
- `offset` integer
- `originalImg` boolean
- `safeSearch` 'Off' | 'Moderate' | 'Strict'
- `setLang` string
- `textDecorations` boolean
- `textFormat` 'Raw' | 'Html'

## Headers

- `X-BingApis-SDK` 'true', required
- `Accept` string
- `Accept-Language` string
- `User-Agent` string
- `X-MSEdge-ClientID` string
- `X-MSEdge-ClientIP` string
- `X-Search-Location` string

## Response `200`

Success.

- News — Response base
  - `_type` string, required

## Other responses

- `default` — An error has occurred. Check the response type and/or status code for more details.

---

[API](https://skmtc.net/azure/apis/news-search-client.md) · [All operations](https://skmtc.net/azure/apis/news-search-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/news-search-client/versions/91f1032a90cc/schema)