# VALUE SERP's documented calls on SpecStream

Date: 2026-11-10

Client: requests 2.34.2 (PyPI), Python 3.14.4, as in VALUE SERP's own Python example

The one line a user changes:

```python
requests.get("https://api.specstream.ai/valueserp/search", {"api_key": SPECSTREAM_KEY, "q": "pizza"})
```

## Request parameters

| Parameter | Sent | Status | Result |
| --- | --- | --- | --- |
| `q` | `q=Larkspur Colorado mayor` | 200 | honoured |
| `num` | `num=5` | 200 | honoured |
| `page` | `page=2` | 200 | honoured |
| `time_period` | `time_period=last_week` | 200 | honoured |
| `time_period=custom` | `time_period=custom`, `time_period_min=01/01/2025`, `time_period_max=06/30/2025` | 200 | honoured |
| `tbs` | `tbs=qdr:m` | 200 | honoured |
| `include_ai_overview` | `include_ai_overview=true` | 200 | honoured |
| `location` | `location=Austin,Texas,United States` | 200 | accepted, not applied |
| `location_auto` | `location_auto=false` | 200 | accepted, not applied |
| `uule` | `uule=w+CAIQICINVW5pdGVkIFN0YXRlcw` | 200 | accepted, not applied |
| `google_domain` | `google_domain=google.co.uk` | 200 | accepted, not applied |
| `gl` | `gl=fr` | 200 | accepted, not applied |
| `hl` | `hl=fr` | 200 | accepted, not applied |
| `lr` | `lr=lang_fr` | 200 | accepted, not applied |
| `cr` | `cr=countryFR` | 200 | accepted, not applied |
| `nfpr` | `nfpr=1` | 200 | accepted, not applied |
| `filter` | `filter=0` | 200 | accepted, not applied |
| `safe` | `safe=active` | 200 | accepted, not applied |
| `device` | `device=mobile` | 200 | accepted, not applied |
| `max_page` | `max_page=2` | 200 | accepted, not applied |
| `include_answer_box` | `include_answer_box=true` | 200 | accepted, not applied |
| `flatten_results` | `flatten_results=true` | 200 | accepted, not applied |
| `include_fields` | `include_fields=organic_results` | 200 | accepted, not applied |
| `hide_base64_images` | `hide_base64_images=true` | 200 | accepted, not applied |
| `output` | `output=csv` | 200 | accepted, not applied (the reply is JSON) |
| `search_type` | `search_type=news` | 400 | refused (news results) |
| `api_pagination.next` | `page=2` | 200 | honoured |
| `api_key (none)` | `api_key=` | 401 | refused |

## Response fields

| Field | State |
| --- | --- |
| `request_info.success` | present |
| `request_info.credits_used` | absent |
| `request_info.credits_remaining` | absent |
| `search_metadata.created_at` | present |
| `search_metadata.processed_at` | present |
| `search_metadata.total_time_taken` | present |
| `search_metadata.engine_url` | absent |
| `search_metadata.json_url` | absent |
| `search_metadata.html_url` | absent |
| `search_parameters.q` | present |
| `search_parameters.engine` | present |
| `search_parameters.location` | absent |
| `search_information.original_query_yields_zero_results` | present |
| `search_information.total_results` | present |
| `search_information.time_taken_displayed` | present |
| `search_information.query_displayed` | present |
| `search_information.search_tabs` | absent |
| `pagination.current` | present |
| `pagination.next` | absent |
| `pagination.other_pages` | absent |
| `pagination.api_pagination.next` | present |
| `pagination.api_pagination.other_pages` | present |
| `organic_results[].position` | present |
| `organic_results[].title` | present |
| `organic_results[].link` | present |
| `organic_results[].domain` | present |
| `organic_results[].displayed_link` | present |
| `organic_results[].snippet` | present |
| `organic_results[].prerender` | absent |
| `organic_results[].snippet_matched` | absent |
| `organic_results[].block_position` | absent |
| `organic_results[].sitelinks` | absent |
| `organic_results[].rich_snippet` | absent |
| `organic_results[].about_this_result` | absent |
| `organic_results[].date` | present |
| `organic_results[].date_utc` | absent |
| `answer_box` | absent |
| `ai_overview` | absent |
| `knowledge_graph` | absent |
| `related_searches` | absent |
| `related_questions` | absent |
| `top_stories` | absent |
| `local_results` | absent |
| `ads` | absent |