# Serper's news search on SpecStream

Date: 2026-11-10

Client: requests 2.34.2 (PyPI), Python 3.14.4

The one line a user changes:

```python
requests.post("https://api.specstream.ai/serper/news", headers={"X-API-KEY": SPECSTREAM_KEY, "Content-Type": "application/json"}, data=payload)
```

## Request parameters

| Parameter | Sent | Status | Result |
| --- | --- | --- | --- |
| `q` | `q=Nvidia earnings` | 200 | honoured |
| `num` | `num=5` | 200 | honoured |
| `page` | `page=2`, `num=3` | 200 | honoured |
| `gl` | `gl=de` | 200 | accepted, not applied |
| `hl` | `hl=fr` | 200 | accepted, not applied |
| `tbs (qdr)` | `tbs=qdr:w` | 200 | honoured |
| `tbs (sbd)` | `tbs=sbd:1` | 200 | honoured |
| `location` | `location=Paris, France` | 200 | accepted, not applied |
| `autocorrect` | `autocorrect=False` | 200 | accepted, not applied |
| `GET with apiKey` | `apiKey=<key>` | 200 | honoured |
| `X-API-KEY (none)` | `X-API-KEY=` | 401 | refused |

## Response fields

| Field | State |
| --- | --- |
| `searchParameters.q` | present |
| `searchParameters.type` | present |
| `searchParameters.num` | present |
| `searchParameters.page` | present |
| `searchParameters.engine` | present |
| `news[].title` | present |
| `news[].link` | present |
| `news[].snippet` | present |
| `news[].date` | present |
| `news[].source` | present |
| `news[].imageUrl` | absent |
| `news[].position` | present |
| `credits` | present |