# Bing News Search's Python SDK on SpecStream

Date: 2026-11-10

Client: azure-cognitiveservices-search-newssearch 2.0.0 (PyPI), Python 3.14.4

The one line a user changes:

```python
client = NewsSearchClient(endpoint="https://api.specstream.ai", credentials=CognitiveServicesCredentials(SPECSTREAM_KEY))
```

## Request parameters

| Parameter | Sent | Status | Result |
| --- | --- | --- | --- |
| `q` | `q=Nvidia earnings` | 200 | honoured |
| `count` | `count=5` | 200 | honoured |
| `offset` | `offset=2` | 200 | honoured |
| `freshness` | `freshness=Day` | 200 | honoured |
| `sortBy` | `sortBy=Date` | 200 | honoured |
| `mkt` | `mkt=de-DE` | 200 | honoured |
| `setLang` | `setLang=fr` | 200 | honoured |
| `cc` | `cc=JP` | 200 | accepted, not applied |
| `safeSearch` | `safeSearch=Strict` | 200 | accepted, not applied |
| `originalImg` | `originalImg=true` | 200 | accepted, not applied |
| `textDecorations` | `textDecorations=true` | 200 | accepted, not applied |
| `textFormat` | `textFormat=HTML` | 200 | accepted, not applied |
| `count (101)` | `count=101` | 400 | refused (Bing's limit is 100) |
| `category (/news)` | `category=Business` | 200 | honoured |
| `Ocp-Apim-Subscription-Key (not a key)` | `key=not-a-key` | 401 | refused |

## Response fields

| Field | State |
| --- | --- |
| `_type` | present |
| `queryContext.originalQuery` | present |
| `totalEstimatedMatches` | present |
| `sort[].id` | present |
| `sort[].isSelected` | present |
| `sort[].url` | present |
| `relatedTopics` | absent |
| `value[].name` | present |
| `value[].url` | present |
| `value[].description` | present |
| `value[].datePublished` | present |
| `value[].provider[].name` | present |
| `value[].provider[]._type` | present |
| `value[].image` | absent |
| `value[].category` | absent |
| `value[].about` | absent |
| `value[].mentions` | absent |
| `value[].clusteredArticles` | absent |
| `value[].video` | absent |
| `value[].headline` | absent |
