Query with 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​

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

{
  "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:

• The "organic" array contains merged results from all internally fetched pages, re-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.

---

Pricing & Billing​

• The initial (first) page is billed at the regular request price.

• All subsequent pages fetched to satisfy resultsNum are billed as paginated pages, at a discounted rate.

• You are billed only for pages that successfully completed and contributed to the final merged response.

• For exact rates and discounts, please consult your Account Manager.