# News Search Client API

> News Search Client API on Apizie: 3 endpoints (The News Category API lets you search on Bing and get back a list of top news articles by category. This…, The News Search API lets you send a search query to Bing and get back a list of news that are relevant to…, The News Trending Topics API lets you search on Bing and get back a list of trending news topics that are…) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-news-search/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:microsoft-cognitiveservices-news-search`
- Category: Dev Tools
- Status: byok
- Source: https://microsoft.com
- Page: https://apizie.tech/api/dev-tools/microsoft-cognitiveservices-news-search
- OpenAPI: https://apizie.tech/api/dev-tools/microsoft-cognitiveservices-news-search/openapi.json

The News Search API lets you send a search query to Bing and get back a list of news that are relevant to the search query. This section provides technical details about the query parameters and headers that you use to…

## Endpoints

### The News Category API lets you search on Bing and get back a list of top news articles by category. This…
`GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-news-search/news-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-BingApis-SDK | string | yes | Activate swagger compliance |
| Accept-Language | string | no | A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing order of preference. For… |
| X-MSEdge-ClientID | string | no | Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often flights new features and improvements,… |
| X-MSEdge-ClientIP | string | no | The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location. Bing uses the location information… |
| X-Search-Location | string | no | A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing uses the location information to… |
| cc | string | no | A 2-character country code of the country where the results come from. This API supports only the United States market. If you specify… |
| category | string | no | The category of articles to return. For example, Sports articles or Entertainment articles. For a list of possible categories, see [News… |
| count | integer | no | The number of news articles to return in the response. The actual number delivered may be less than requested. The default is 10 and the… |
| headlineCount | integer | no | The number of headline articles to return in the response. The default is 12. Specify this parameter only if you do not specify the… |
| mkt | string | no | The market where the results come from. Typically, mkt is the country where the user is making the request from. However, it could be a… |
| offset | integer | no | The zero-based offset that indicates the number of news to skip before returning news. The default is 0. The offset should be less than… |
| originalImg | boolean | no | A Boolean value that determines whether the image's contentUrl contains a URL that points to a thumbnail of the original article's image… |
| safeSearch | string | no | Filter news for adult content. The following are the possible filter values. Off: Return news articles with adult text, images, or videos.… |
| setLang | string | no | The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language code. For example, the language… |
| textDecorations | boolean | no | A Boolean value that determines whether display strings contain decoration markers such as hit highlighting characters. If true, the… |
| textFormat | string | no | The type of markers to use for text decorations (see the textDecorations query parameter). Possible values are Raw—Use Unicode characters… |

### The News Search API lets you send a search query to Bing and get back a list of news that are relevant to…
`GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-news-search/news-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-BingApis-SDK | string | yes | Activate swagger compliance |
| Accept-Language | string | no | A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing order of preference. For… |
| X-MSEdge-ClientID | string | no | Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often flights new features and improvements,… |
| X-MSEdge-ClientIP | string | no | The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location. Bing uses the location information… |
| X-Search-Location | string | no | A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing uses the location information to… |
| cc | string | no | A 2-character country code of the country where the results come from. This API supports only the United States market. If you specify… |
| count | integer | no | The number of news articles to return in the response. The actual number delivered may be less than requested. The default is 10 and the… |
| freshness | string | no | Filter news by the date and time that Bing discovered the news. The following are the possible filter values. Day: Return news discovered… |
| mkt | string | no | The market where the results come from. Typically, mkt is the country where the user is making the request from. However, it could be a… |
| offset | integer | no | The zero-based offset that indicates the number of news to skip before returning news. The default is 0. The offset should be less than… |
| originalImg | boolean | no | A Boolean value that determines whether the image's contentUrl contains a URL that points to a thumbnail of the original article's image… |
| q | string | yes | The user's search query string. The query string cannot be empty. The query string may contain [Bing Advanced… |
| safeSearch | string | no | Filter news for adult content. The following are the possible filter values. Off: Return news articles with adult text, images, or videos.… |
| setLang | string | no | The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language code. For example, the language… |
| sortBy | string | no | The order to return the news in. The following are the possible case-insensitive values. Date: If the request is through the News Search… |
| textDecorations | boolean | no | A Boolean value that determines whether display strings contain decoration markers such as hit highlighting characters. If true, the… |
| textFormat | string | no | The type of markers to use for text decorations (see the textDecorations query parameter). Possible values are Raw—Use Unicode characters… |

### The News Trending Topics API lets you search on Bing and get back a list of trending news topics that are…
`GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-news-search/news-trending` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-BingApis-SDK | string | yes | Activate swagger compliance |
| Accept-Language | string | no | A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing order of preference. For… |
| X-MSEdge-ClientID | string | no | Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often flights new features and improvements,… |
| X-MSEdge-ClientIP | string | no | The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location. Bing uses the location information… |
| X-Search-Location | string | no | A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing uses the location information to… |
| cc | string | no | A 2-character country code of the country where the results come from. This API supports only the United States market. If you specify… |
| count | integer | no | The number of news articles to return in the response. The actual number delivered may be less than requested. The default is 10 and the… |
| mkt | string | no | The market where the results come from. Typically, mkt is the country where the user is making the request from. However, it could be a… |
| offset | integer | no | The zero-based offset that indicates the number of news to skip before returning news. The default is 0. The offset should be less than… |
| safeSearch | string | no | Filter news for adult content. The following are the possible filter values. Off: Return news articles with adult text, images, or videos.… |
| setLang | string | no | The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language code. For example, the language… |
| since | integer | no | The Unix epoch time (Unix timestamp) that Bing uses to select the trending topics. Bing returns trending topics that it discovered on or… |
| sortBy | string | no | The order to return the news in. The following are the possible case-insensitive values. Date: If the request is through the News Search… |
| textDecorations | boolean | no | A Boolean value that determines whether display strings contain decoration markers such as hit highlighting characters. If true, the… |
| textFormat | string | no | The type of markers to use for text decorations (see the textDecorations query parameter). Possible values are Raw—Use Unicode characters… |

## Example
```
curl "https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-news-search/news-category" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the News Search Client API?
Create a free Apizie key, then send GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-news-search/news-category with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the News Search Client API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. News Search Client itself also needs your own key from microsoft.com.

### Can AI agents use the News Search Client API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:microsoft-cognitiveservices-news-search.

### What is the status of the News Search Client API?
Needs your own provider key (bring your own key)