Google Shopping Light Pagination API

The Google Shopping Light API scrapes the current page number, as well as the links to the previous and next pages, enabling more precise control for retrieving the next and previous result sets.


The start parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 20 is the 2nd page of results, 40 is the 3rd page of results, etc.).


The num parameter defines the maximum number of results to return. (e.g., 20 (default) returns 20 results, 40 returns 40 results, and 100 (maximum) returns 100 results).
Any number greater than maximum number (100) will default to 100.

API Examples

Results for: macbook

Results for: macbook

JSON Example

{
  ...
  "shopping_results": [
    ...
    {
      "position": 17,
      "block_position": "top",
      "title": "Apple MacBook Air 13.3 inch Laptop - Space Gray, M1 Chip, Built for Apple Intelligence, 8GB Ram, 256gb storage",
      "price": "$649.00",
      "extracted_price": 649.0,
      "tracking_link": "https://www.google.com/aclk?sa=l&ai=DChcSEwif8Jzyi8iNAxXMYUgAHTmkHJQYABAhGgJjZQ&co=1&ase=2&gclid=EAIaIQobChMIn_Cc8ovIjQMVzGFIAB05pByUEAQYESABEgL7HPD_BwE&category=acrcp_v1_48&sig=AOD64_0pVY044Naklkj6v2risLeyJQB2aw&ctype=46&nis=4&ved=0ahUKEwi1lJnyi8iNAxVyK7kGHaW7Ia4QqygIdA&adurl=",
      "source": "walmart",
      "rating": 5,
      "reviews": 19599,
      "thumbnail": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSrtQwUFfLBvnZGstwTDP2qV-7BB7L9rIRpsSsypiRiR62nuQfJkiaVgrWpvotmA900qDlFgyJZHMit2zwVdrYangzF2Rf6PPIHegUXLy19bOcsY3cBx_Mprg&usqp=CAE",
      "serpapi_thumbnail": "https://serpapi.com/images/url/3XjZtnicDcndEoFAGADQt3FHyQxTM8aUhCb0o_zcmGy1drB97X6VvJlH8Tac2_P93BBBGoqScyI6wDzr45WrAyoxRUYGpHwq8lYCME5n1fR_hrnN9CWJBAZt7BSe1fDzUmK7t32tSvoTy5p4uliHICPZAQtZONZ4HRTunaUJFQdoSnyauqpW9sOhnXtebRhq7zbJxCnl9O1oYTH2_fUqp_HR64b6dUfkaUSs12UDgvZqWcF0bi5-Z2FDYQ",
      "extensions": [
        "Pick up today",
        "CURBSIDE"
      ],
      "tag": "CURBSIDE"
    }
  ],
  ...
  "pagination": {
    "next": "https://www.google.com/search?q=macbook&sca_esv=e7d273e99eea7fed&gbv=1&hl=en&gl=us&tbm=shop&ei=NgQ4aLWhFfLW5OUPpfeG8Qo&start=20&sa=N&liteui=1"
  },
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?engine=google_shopping_light&gl=us&google_domain=google.com&hl=en&q=macbook&start=20"
  }
}

Results for: macbook with num=40

Results for: macbook with num=40

JSON Example

{
  ...
  "shopping_results": [
    ...
    {
      "position": 40,
      "block_position": "top",
      "title": "Apple Refurbished 2017 MacBook Air 13 128GB & 1 Year Warranty,Blue",
      "price": "$359.95",
      "extracted_price": 359.95,
      "second_hand_condition": "refurbished",
      "tracking_link": "https://www.google.com/aclk?sa=l&ai=DChcSEwji_5fZmemNAxW4j1AGHaTJMzAYABBPGgJkZw&co=1&gclid=EAIaIQobChMI4v-X2ZnpjQMVuI9QBh2kyTMwEAQYKCABEgLyYfD_BwE&sig=AOD64_0Gf7wbTQpt7xeqDMyoL2Ko3FNt9g&ctype=5&ved=0ahUKEwiNyZPZmemNAxW2QUEAHUi3JnIQww8IygE&adurl=",
      "source": "qvc",
      "rating": 4.5,
      "reviews": 7872,
      "thumbnail": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSX1fnzAXAHnYOlJopDD6tIbfzg6tTsiihbosH-1uIL8x_Rl7WcWUJUYSKwE4e6hO3OvVAdoWDem3bwfvMJC4wU61vWJVby67IH9ouuMGrxs7TMqpUYGKMs0g&usqp=CAE",
      "serpapi_thumbnail": "https://serpapi.com/images/url/5xbNmnicDclJDoIwAADA33hDRElRE2MaIGwiiYjAydiyJtAWW9af-RR_o3Od76cSgvGjLOcEv2cm8kwSiGzXJRcvUeM1pq3MK8pYTcpzd_rfEV6zg4XDRCnIAhNokzRoXMoMAwgHFUsJxJ3XdYUotyWldy776XlrtBjHkRuloTeaag6qYBcMD5jR2MjbHRqLwXd1dYyAMsTuA81Ac-wD7Xvfek9cu_sdi1LL8_mmXPW8Yycdmj8jGUIz"
    }
  ],
  ...
  "pagination": {
    "next": "https://www.google.com/search?q=macbook&num=40&sca_esv=954ba678d3f37bee&gbv=1&gl=us&hl=en&tbm=shop&ei=319JaM3dEbaDhbIPyO6akQc&start=40&sa=N&liteui=1"
  },
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?engine=google_shopping_light&gl=us&google_domain=google.com&hl=en&num=40&q=macbook&start=40"
  }
}

Results for: macbook with start=20

Results for: macbook with start=20

JSON Example

{
  ...
  "shopping_results": [
    ...
    {
      "position": 20,
      "title": "Apple 13\" MacBook Pro - Space Gray - M1 Chip (2020)",
      "link": "https://www.ebay.com/itm/405802463358?chn=ps&mkevt=1&mkcid=28&google_free_listing_action=view_item",
      "product_link": "https://www.google.com/shopping/product/1841146476631487892?gl=us",
      "product_id": "1841146476631487892",
      "serpapi_product_api": "https://serpapi.com/search.json?engine=google_product&gl=us&google_domain=google.com&hl=en&product_id=1841146476631487892",
      "immersive_product_page_token": "eyJwcm9kdWN0aWQiOiI4Nzc3MDE1NDQ1MDQ4NTA1OTciLCJjYXRhbG9naWQiOiIxODQxMTQ2NDc2NjMxNDg3ODkyIiwiaGVhZGxpbmVPZmZlckRvY2lkIjoiNDc4Mjg4ODM5NDY2MDk1NzMxOCIsInF1ZXJ5IjoibWFjYm9vayJ9",
      "serpapi_immersive_product_api": "https://serpapi.com/search.json?engine=google_immersive_product&page_token=eyJwcm9kdWN0aWQiOiI4Nzc3MDE1NDQ1MDQ4NTA1OTciLCJjYXRhbG9naWQiOiIxODQxMTQ2NDc2NjMxNDg3ODkyIiwiaGVhZGxpbmVPZmZlckRvY2lkIjoiNDc4Mjg4ODM5NDY2MDk1NzMxOCIsInF1ZXJ5IjoibWFjYm9vayJ9",
      "number_of_comparisons": "5+",
      "comparison_link": "https://www.google.com/shopping/product/1841146476631487892?q=macbook&gl=us&gbv=1&ie=UTF-8&hl=en&prds=epd:4782888394660957318,oid:4782888394660957318,pid:877701544504850597&liteui=1&sa=X&ved=0ahUKEwiojPramemNAxWks5UCHQ_oDgk4FBDZKwicAg",
      "serpapi_product_api_comparisons": "https://serpapi.com/search.json?engine=google_product&filter=epd%3A4782888394660957318%2Coid%3A4782888394660957318%2Cpid%3A877701544504850597&gbv=1&gl=us&hl=en&ie=UTF-8&liteui=1&offers=1&product_id=1841146476631487892&sa=X&ved=0ahUKEwiojPramemNAxWks5UCHQ_oDgk4FBDZKwicAg",
      "source": "from eBay",
      "price": "$89.99",
      "extracted_price": 89.99,
      "second_hand_condition": "used",
      "rating": 5,
      "reviews": 4986,
      "thumbnail": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcS9vTV-dm6_V0JWz2SBO8vB4lfTLRikpECqXCwYjr1TPDP3hen3HXfkCM94GJMPEnjccY4-AVTq4ztXkKW_XHwJv-xbmVt_yBy0Vy7MrA2q8546SomAlQ&usqp=CAE",
      "serpapi_thumbnail": "https://serpapi.com/images/url/tRm3u3icDcldEkJAAADg2_Tmp2yiGdMsmRqlFLN4MrUUYe2yKe7VYbpNfa_f95NzTrulJGUEtwPlWSrwK5HFe8cvvMAibmqpyxtKC3JfMeN_S3hI9Q329T5AQlqrCZKdcJz55lHrTVDdgv25KKltsch6xY92GnhrT8kzomyjW2m5Otg4rmeTB8YxECAKGBh5VO7CJNq-nF54X2vEk8EcZDQs3BbOmDYHqt_UsDpNnh2jhgXtH6RkP4w",
      "delivery": "Free shipping"
    }
  ],
  ...
  "pagination": {
    "previous": "https://www.google.com/search?q=macbook&sca_esv=954ba678d3f37bee&gl=us&gbv=1&hl=en&tbm=shop&ei=419JaOiOBKTn1sQPj9C7SA&start=0&sa=N&liteui=1",
    "current": 2,
    "next": "https://www.google.com/search?q=macbook&sca_esv=954ba678d3f37bee&gl=us&gbv=1&hl=en&tbm=shop&ei=419JaOiOBKTn1sQPj9C7SA&start=40&sa=N&liteui=1"
  },
  "serpapi_pagination": {
    "current": 2,
    "previous": "https://serpapi.com/search.json?engine=google_shopping_light&gl=us&google_domain=google.com&hl=en&q=macbook&start=0",
    "next": "https://serpapi.com/search.json?engine=google_shopping_light&gl=us&google_domain=google.com&hl=en&q=macbook&start=40"
  }
}

Results for: macbook with start=40 and num=40

Results for: macbook with start=40 and num=40

JSON Example

{
  ...
  "shopping_results": [
    ...
    {
      "position": 40,
      "title": "Apple 13\" MacBook Pro: Apple M2 Chip 8C CPU,10C GPU, 16GB Ram and 256GB SSD - Space Grey",
      "link": "https://www.walmart.com/ip/Restored-Apple-13-3-MacBook-Pro-Apple-M2-8-Core-Chip-16GB-RAM-256GB-SSD-Space-Gray-Good-Refurbished/15407562263?wmlspartner=wlpa&selectedSellerId=101135860&selectedOfferId=72FAE3E29817383A88443CEF4A201921&conditionGroupCode=2",
      "product_link": "https://www.google.com/shopping/product/13172084143614653923?gl=us",
      "product_id": "13172084143614653923",
      "serpapi_product_api": "https://serpapi.com/search.json?engine=google_product&gl=us&google_domain=google.com&hl=en&product_id=13172084143614653923",
      "immersive_product_page_token": "eyJwcm9kdWN0aWQiOiI5MjIzODk5NDQ4ODc3NjM3MTY2IiwiY2F0YWxvZ2lkIjoiMTMxNzIwODQxNDM2MTQ2NTM5MjMiLCJoZWFkbGluZU9mZmVyRG9jaWQiOiI2MzY3MTI4OTAxMTE3Mjk0NjA4IiwicXVlcnkiOiJtYWNib29rIn0=",
      "serpapi_immersive_product_api": "https://serpapi.com/search.json?engine=google_immersive_product&page_token=eyJwcm9kdWN0aWQiOiI5MjIzODk5NDQ4ODc3NjM3MTY2IiwiY2F0YWxvZ2lkIjoiMTMxNzIwODQxNDM2MTQ2NTM5MjMiLCJoZWFkbGluZU9mZmVyRG9jaWQiOiI2MzY3MTI4OTAxMTE3Mjk0NjA4IiwicXVlcnkiOiJtYWNib29rIn0%3D",
      "number_of_comparisons": "2",
      "comparison_link": "https://www.google.com/shopping/product/13172084143614653923?num=40&sourceid=chrome&hl=en&q=macbook&gbv=1&gl=us&prds=epd:6367128901117294608,oid:6367128901117294608,pid:9223899448877637166&liteui=1&sa=X&ved=0ahUKEwjP4uncmemNAxVJGFkFHboaK1g4KBDZKwjxAg",
      "serpapi_product_api_comparisons": "https://serpapi.com/search.json?engine=google_product&filter=epd%3A6367128901117294608%2Coid%3A6367128901117294608%2Cpid%3A9223899448877637166&gbv=1&gl=us&hl=en&liteui=1&offers=1&product_id=13172084143614653923&sa=X&sourceid=chrome&ved=0ahUKEwjP4uncmemNAxVJGFkFHboaK1g4KBDZKwjxAg",
      "source": "from Walmart - Seller",
      "price": "$784.95",
      "extracted_price": 784.95,
      "second_hand_condition": "used",
      "rating": 5,
      "reviews": 20699,
      "thumbnail": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSdSLy3xqNEsFpw9NmTPQmgLrGY-ThBkn7rg2QtdJzMyQAPdmeUuRwKp4dEw9jxfd6_43ngEYVQbOcnrUYF7PlzmYRS8_FKHMGg6qaRxOZpCsSugcqKhXY&usqp=CAE",
      "serpapi_thumbnail": "https://serpapi.com/images/url/PIg0FHicDcnbCoIwAADQv-mthJJMQcJCjbxrRutFdLPZZXNzE7UP61_6mzqv5_tppGTCUJSawm5iskZzWdHlAgtZyjtcwJYoomkZu1O85eb_DCtEugszlPnTauShLRw26CE5xQnBfueC-anZPanW4WUi0fEdTIkVI1LnfTp4TEX2oD_GG1oX6opiG5yTKoK0y4Gjxa83AWm2KRzvELh4zct0jK5sL7IeQ-41FzDrBWfm3rJ_lI1CPQ",
      "delivery": "Free shipping"
    }
  ],
  ...
  "pagination": {
    "previous": "https://www.google.com/search?q=macbook&num=40&sca_esv=954ba678d3f37bee&hl=en&gbv=1&gl=us&tbm=shop&ei=5l9JaM_XPMmw5NoPurWswQU&start=0&sa=N&liteui=1",
    "current": 2,
    "next": "https://www.google.com/search?q=macbook&num=40&sca_esv=954ba678d3f37bee&hl=en&gbv=1&gl=us&tbm=shop&ei=5l9JaM_XPMmw5NoPurWswQU&start=80&sa=N&liteui=1"
  },
  "serpapi_pagination": {
    "current": 2,
    "previous": "https://serpapi.com/search.json?engine=google_shopping_light&gl=us&google_domain=google.com&hl=en&num=40&q=macbook&start=0",
    "next": "https://serpapi.com/search.json?engine=google_shopping_light&gl=us&google_domain=google.com&hl=en&num=40&q=macbook&start=80"
  }
}

Results for: macbook with start=3000

Results for: macbook with start=3000

JSON Example

{
  ...
  "search_information": {
    "query_displayed": "macbook",
    "shopping_results_state": "Fully empty"
  },
  "error": "Google hasn't returned any results for this query."
}

JSON structure overview

{
  ...
  "pagination": {
    "current": "Integer - Index of the current page",
    "next": "String - Google link for paginating to the next page of results",
    "previous": "String - Google link for paginating to the previous page of results"
  },
  "serpapi_pagination": {
    "current": "Integer - Index of the current page",
    "next": "String - SerpApi link for paginating to the next page of results",
    "previous": "String - SerpApi link for paginating to the previous page of results"
  },
  ...
}