# SerpApi's Python client on SpecStream: Google News and the News tab

Date: 2026-11-10

Client: serpapi 1.2.0 (PyPI), Python 3.14.4

The one line a user changes:

```python
client = serpapi.Client(api_key=SPECSTREAM_KEY); client.BASE_DOMAIN = "https://api.specstream.ai/serpapi-news"
```

## Request parameters

| Parameter | Sent | Status | Result |
| --- | --- | --- | --- |
| `q` | `q=Nvidia earnings` | 200 | honoured |
| `gl` | `gl=fr`, `hl=fr` | 200 | honoured |
| `hl` | `hl=de` | 200 | honoured |
| `so` | `so=1` | 200 | honoured |
| `topic_token` | `q=`, `topic_token=CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx6TVdZU0FtVnVHZ0pWVXlnQVAB` | 200 | accepted, not applied |
| `publication_token` | `q=`, `publication_token=CAAqBwgKMKHL9QowkqbaAg` | 200 | accepted, not applied |
| `section_token` | `q=`, `topic_token=CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx6TVdZU0FtVnVHZ0pWVXlnQVAB`, `section_token=CAQiQ0NCQVNMQW9JTDIwdk1EbHpNV1lTQW1WdUdnSlZVeUlOQ0FRYUNRb0hMMjB2TUcxcmVpb0pFZ2N2YlM4d2JXdDZLQUEqKggAKiYICiIgQ0JBU0Vnb0lMMjB2TURsek1XWVNBbVZ1R2dKVlV5Z0FQAVAB` | 200 | accepted, not applied |
| `story_token` | `q=`, `story_token=CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2lLdzc2QURSRV9zNGpCa0Vqa3dDZ0FQAQ` | 200 | accepted, not applied |
| `kgmid` | `q=`, `kgmid=/m/0vzm` | 200 | accepted, not applied |
| `no_cache` | `no_cache=true` | 200 | accepted, not applied |
| `num (google_news)` | `num=5` | 200 | honoured |
| `tbm=nws q` | `engine=google`, `tbm=nws`, `q=Nvidia earnings` | 200 | honoured |
| `tbm=nws num` | `engine=google`, `tbm=nws`, `num=5` | 200 | honoured |
| `tbm=nws start` | `engine=google`, `tbm=nws`, `start=10` | 200 | honoured |
| `tbm=nws tbs (qdr)` | `engine=google`, `tbm=nws`, `tbs=qdr:d` | 200 | honoured |
| `tbm=nws tbs (sbd)` | `engine=google`, `tbm=nws`, `tbs=sbd:1` | 200 | honoured |
| `tbm=nws hl` | `engine=google`, `tbm=nws`, `hl=de`, `gl=de` | 200 | honoured |
| `tbm=nws location` | `engine=google`, `tbm=nws`, `location=Austin, Texas, United States` | 200 | accepted, not applied |
| `tbm=nws safe` | `engine=google`, `tbm=nws`, `safe=active` | 200 | accepted, not applied |
| `engine (other)` | `engine=bing` | 400 | refused (another engine) |
| `tbm=nws next page (next_page())` | `start=10` | 200 | honoured |
| `api_key (none)` | `api_key=` | 401 | refused |

## Response fields

| Field | State |
| --- | --- |
| `search_metadata.id` | present |
| `search_metadata.status` | present |
| `search_metadata.created_at` | present |
| `search_metadata.total_time_taken` | present |
| `search_parameters.engine` | present |
| `search_parameters.q` | present |
| `news_results[].position` | present |
| `news_results[].title` | present |
| `news_results[].source.name` | present |
| `news_results[].source.icon` | absent |
| `news_results[].source.authors` | absent |
| `news_results[].link` | present |
| `news_results[].thumbnail` | absent |
| `news_results[].date` | present |
| `news_results[].iso_date` | present |
| `news_results[].highlight` | absent |
| `news_results[].stories` | absent |
| `menu_links` | absent |
| `related_topics` | absent |
| `(tbm=nws) search_information.query_displayed` | present |
| `(tbm=nws) search_information.total_results` | present |
| `(tbm=nws) news_results[].position` | present |
| `(tbm=nws) news_results[].link` | present |
| `(tbm=nws) news_results[].title` | present |
| `(tbm=nws) news_results[].source` | present |
| `(tbm=nws) news_results[].date` | present |
| `(tbm=nws) news_results[].published_at` | present |
| `(tbm=nws) news_results[].snippet` | present |
| `(tbm=nws) news_results[].favicon` | absent |
| `(tbm=nws) news_results[].thumbnail` | absent |
| `(tbm=nws) top_news` | absent |
| `(tbm=nws) serpapi_pagination.current` | present |
| `(tbm=nws) serpapi_pagination.next` | present |