Google Shopping Results API

/ Home / Google Search API / Shopping Results

To scrape Google shopping results with SerpApi, create a search with tbm parameter set to shop. (I.e., tbm=shop) The Google Shopping Results API allows a user to scrape the results of a Google Shopping search. The user must utilize the tbm parameter and set the corresponding value to shop (e.g.: tbm=shop). A user may utilize the standard parameters available. Searches for results outside the U.S. should refrain from utilizing the location parameter and only utilize our Localization parameters when seeking country-specific results: google_domain, gl, hl, and lr.

SerpApi Shopping Results JSON

{
  ...
  "filters": [
    {
      "type": "String - Block title",
      "options": [
        {
          "text": "String - Filter name",
          "tbs": "String - tbs value"
        },
        ...
      ]
    },
    ...
  ],
  "shopping_results": [
    {
      "position": "Integer - Item position",
      "title": "String - Item title",
      "link": "String - Link to the Google item page",
      "price": "String - Item price",
      "rating": "Float - Item rating",
      "reviews": "String - Item review count",
      "snippet": "String - Item description",
      "extensions": "String - Item tags/extensions",
      "thumbnail": "Image - Base64 data or URL"
    },
  ...
}

Shopping Results for "TV"

Shopping Results for "TV"

JSON Example

{
  ...
  "shopping_results": [
    {
      "position": 1,
      "title": "Sharp LC 50LBU591U - 50" LED Smart TV - 4K UltraHD",
      "link": "https://www.google.com/shopping/product/114263478077240973?gl=us&uule=w+CAIQICIaRGFsbGFzLFRleGFzLFVuaXRlZCBTdGF0ZXM&q=TV&hl=en&prds=paur:ClkAsKraXxipTn9A6bKBnKTN-iJDZpGToM9BsCKp86Fl2AyybyUk_A3BWNtg90fUVlilqx5q5sNXB1wI6ryk72_WJPCAftxZpA-EfK6iNBq2gWN8ZUp4WvSzZhIZAFPVH712pT5g0Ev93Etf0dDxNmM1Ux6MNQ&sa=X&ved=0ahUKEwiYm8_F68fhAhVPD7kGHTe4DB0Q8wII5gQ",
      "source": "from 2 stores",
      "price": "$379.99",
      "rating": 4.6,
      "reviews": 7005,
      "snippet": "Only at Best Buy Watch your favorite films or shows in comfort with this Sharp 4K TV. High resolutions produce images that are ...",
      "extensions": [
        "January 2017",
        "High Definition",
        "Smart TV",
        "29.3 lb",
        "50 in",
        "Sharp",
        "LCD",
        "4K",
        "44.4 in wide",
        "3.3 in deep"
      ],
      "thumbnail": "data:image/webp;base64,/9j/4AAQSkZJRgABAQ...4hyQGxggggP/9kx3d"
    },
    {
      "position": 2,
      "title": "Sceptre X505BV-FSR - 50" LED TV - 1080p",
      "link": "https://www.google.com/shopping/product/16618293882053925702?gl=us&uule=w+CAIQICIaRGFsbGFzLFRleGFzLFVuaXRlZCBTdGF0ZXM&q=TV&hl=en&prds=paur:ClkAsKraX2NF1_nIXzU2tJia8OhgsZ5Jy5KTe7fLen2AnK0HJPm9_I-OPFHYMK2p7BlrqWENqTYRtR1WYX_OKXNKYBIofCPTBHoJiQmtcn77unIEnd98nVF8lhIZAFPVH70Aguzrd3BhgboYfxx3erAh_eDO3g&sa=X&ved=0ahUKEwiYm8_F68fhAhVPD7kGHTe4DB0Q8wII_AQ",
      "source": "from 10+ stores",
      "price": "$209.99",
      "rating": 4.2,
      "reviews": 3755,
      "snippet": "The S-Series Full HD TCL Roku TV puts all your entertainment favorites in one place, allowing seamless access to over 450,000 ...",
      "extensions": [
        "June 2017",
        "High Definition",
        "50 in",
        "Sceptre",
        "LCD",
        "1080p",
        "44.1 in wide",
        "LED",
        "1 HDMI Port",
        "1920 x 1080"
      ],
      "thumbnail": "data:image/webp;base64,/9j/4AAQSkZJRgABAQA...BSxXtKgD/9kx3d"
    },
    {
      "position": 3,
      "title": "Insignia NS-32DF310NA19 - 32" HD Smart LED TV - 720p - Fire TV Edition",
      "link": "https://www.google.com/shopping/product/6461643080097175527?gl=us&uule=w+CAIQICIaRGFsbGFzLFRleGFzLFVuaXRlZCBTdGF0ZXM&q=TV&hl=en&prds=paur:ClkAsKraXxV0jHc3PwJkOvw-GtLgpv6e_8n5Qex0BlMS68LGMdU6egxAEPvUqneNgo0hCooMu_LIK7G2LZm3ISAM-KgX57vZFh91D5obfoZSuGJdq-bEZeyIChIZAFPVH70LPkgZcKgX63Td_T60e_CClf3zaA&sa=X&ved=0ahUKEwiYm8_F68fhAhVPD7kGHTe4DB0Q8wIIkgU",
      "source": "from 3 stores",
      "price": "$119.99",
      "rating": 4.6,
      "reviews": 1369,
      "snippet": "Insignia HDTV Fire TV Edition is a new generation of smart TVs featuring the Fire TV experience built-in and including a Voice ...",
      "extensions": [
        "Smart TV",
        "High Definition",
        "11.2 lb",
        "32 in",
        "Insignia",
        "NS Series",
        "LCD",
        "720p",
        "3 in deep",
        "LED"
      ],
      "thumbnail": "data:image/webp;base64,/9j/4AAQSkZJRgAB...jkKAByFChQAf/Z"
    },
    ...
  ...
}

Shopping Results filters with tbs values

To apply filters for the Google Shopping search, you would need to update the tbs parameter with the appropriate value. SerpApi is able to extract and make sense of this type of data.
e.g. To select "Buy on Google" option, you need to pass vw:l,mr:1,cat:404,root_cat:529656,buy:g,ss:67,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D value to tbs parameter.
e.g. To select multiple filter options, tbs parameter has to be constructed in the next sequence: value + : + value.

Shopping Results filters with tbs values

JSON Example

{
  ...
  "filters": [
    {
      "type": "Show only",
      "options": [
        {
          "text": "Buy on Google",
          "tbs": "vw:l,mr:1,cat:404,root_cat:529656,buy:g,ss:67,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "New items",
          "tbs": "vw:l,mr:1,cat:404,root_cat:529656,new:1,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        }
      ]
    },
    {
      "type": "Price",
      "options": [
        {
          "text": "Up to $400",
          "tbs": "vw:l,mr:1,cat:404,root_cat:529656,price:1,ppr_max:400,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "$400 – $900",
          "tbs": "vw:l,mr:1,cat:404,root_cat:529656,price:1,ppr_min:400,ppr_max:900,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "$900 – $1,500",
          "tbs": "vw:l,mr:1,cat:404,root_cat:529656,price:1,ppr_min:900,ppr_max:1500,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "Over $1,500",
          "tbs": "vw:l,mr:1,cat:404,root_cat:529656,price:1,ppr_min:1500,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        }
      ]
    },
    {
      "type": "Category",
      "options": [
        {
          "text": "TVs",
          "tbs": "vw:l,mr:1,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        }
      ]
    },
    {
      "type": "Brand",
      "options": [
        {
          "text": "Samsung",
          "tbs": "vw:l,mr:1,root_cat:529656,cat:404,pdtr0:708987%7C709001,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "LG",
          "tbs": "vw:l,mr:1,root_cat:529656,cat:404,pdtr0:708987%7C708995,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "TCL",
          "tbs": "vw:l,mr:1,root_cat:529656,cat:404,pdtr0:708987%7C761941,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "VIZIO",
          "tbs": "vw:l,mr:1,root_cat:529656,cat:404,pdtr0:708987%7C709009,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "Sony",
          "tbs": "vw:l,mr:1,root_cat:529656,cat:404,pdtr0:708987%7C709004,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "Hisense",
          "tbs": "vw:l,mr:1,root_cat:529656,cat:404,pdtr0:708987%7C1000526,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        },
        {
          "text": "RCA",
          "tbs": "vw:l,mr:1,root_cat:529656,cat:404,pdtr0:708987%7C709000,init_ar:SgVKAwiUA0oHsgQECPipIA%3D%3D"
        }
      ]
    },
    ...
  ],
  ...
}