# resultsNum

This documentation provides an example of how to send a GET request to the SERP API using the `resultsNum` parameter and interpret the merged response.

***

### API Request with **`resultsNum`**[​](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Pagination#api-request-with-pagination) <a href="#api-request-with-pagination" id="api-request-with-pagination"></a>

```bash
curl --location 'https://serp-api.netnut.io/search?q=news&device=desktop&resultsNum=50&gl=us&hl=en' \
  --header 'Authorization: Basic <base64(username:password)>'
```

In this request, we use:

* `resultsNum` (integer 10–100): the total number of **organic results** you wish to receive in one combined response.

By specifying `resultsNum=50`, the API internally fetches enough paginated pages, merges them (organic results only), and returns a single unified output.

***

**Example API Response**

```json
{
  "url": "https://www.google.com/search?q=news&hl=en&gl=US&start=30&pageIndex=4&totalPages=5",
  "general": {
    "searchEngine": "google",
    "resultsCount": 9810000000,
    "searchTime": 0.46,
    "language": "en",
    "device": "desktop",
    "searchType": "text",
    "pageTitle": "news - Google Search",
    "timestamp": "2025-10-09T07:13:05.054Z",
    "render": false
  },
  "input": {
    "originalUrl": "https://www.google.com/search?q=news&hl=en&gl=US&start=30&pageIndex=4&totalPages=5",
    "jobId": "4f198c74-307b-4eed-961e-45fd12f92302"
  },
  "organic": [
    {
      "title": "Google News",
      "description": "3 hours ago — Read full articles...",
      "link": "https://news.google.com/",
      "displayLink": "https://news.google.com",
      "timeSince": "3 hours ago",
      "rank": 1
    },
    {
      "title": "NBC News – Breaking Headlines …",
      "description": "7 hours ago — Go to NBCNews.com for breaking news…",
      "link": "https://www.nbcnews.com/",
      "displayLink": "https://www.nbcnews.com",
      "timeSince": "7 hours ago",
      "rank": 2
    },
    {
      "title": "Fox News - Breaking News Updates",
      "description": "2 hours ago — Breaking news, latest headlines…",
      "link": "https://www.foxnews.com/",
      "displayLink": "https://www.foxnews.com",
      "timeSince": "2 hours ago",
      "rank": 3
    }
    // … up to the requested count (e.g. 50) or until pages run out
  ],
  "pagination": {
    "currentPage": 1,
    "nextPage": 2,
    "otherPages": {}
  },
  "pagesProcessed": 5
}
```

Notes:

* Usage of `gl`  and `hl`  is mandatory, without it you will get error 400.
* The `"organic"` array contains merged results from all internally fetched pages, ranked continuously.
* If a paginated shard fails, **shards after it are not fetched**, and only results from succeeded shards appear.
* `"pagesProcessed"` indicates how many page‐requests were actually completed.

{% hint style="info" %}
Customers may choose to request all 10 pages at once (`ResultNum=100`). In such cases, all 10 pages are sent concurrently, and therefore all requests are billable—regardless of the actual number of results returned for the specific search term.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-search/resultsnum.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.