Google Refine By API

/ Home / Google Search API / Refine By

For some searches, Google search includes a "Refine by" block. SerpApi is able to scrape, extract and make sense of this information.

SerpApi JSON structure overview:

{
  ...
  "refine_by_%category%": [
    {
      "link": "String - Link to item",
      "title": "String - Displayed title",
      "thumbnail": "String - Displayed thumbnail of item",
    },
  ...
}

Refine by results for "4k tv"

Refine by results for "4k tv"

JSON Example

{
  ...
  "refine_by_brand": [
    {
      "link": "https://www.google.com/search?gl=us&hl=en&q=samsung+4k+tv&sa=X&ved=2ahUKEwjl9uvRmJfmAhXkMn0KHR57Dj0Q_sUBKAAwIHoECBMQAg",
      "title": "Samsung",
      "thumbnail": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQDun_UXwqti_nu1ETshL-XGMp3X86POayPFfVOJHnp7hvmohgRyf1Wtx8-_llKoewJcgUZhUKqS-kPVBsPvdtexVClLnIUdG7ADJNxDetoBRNGXnKTEV9owA"
    },
    {
      "link": "https://www.google.com/search?gl=us&hl=en&q=lg+4k+tv&sa=X&ved=2ahUKEwjl9uvRmJfmAhXkMn0KHR57Dj0Q_sUBKAEwIHoECBMQAw",
      "title": "LG",
      "thumbnail": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSgIo_cBrEbRuapbpCnN5lu66zyM8Yr6rvS6xfk7iIExqJSx13vpQgXi0OvOSCWslUdox5mZl26Xu5QUDpsGJxkKG0YZaVwu_QHYq2oH0tzf4LHwx3OlXlPTg"
    },
    {
      "link": "https://www.google.com/search?gl=us&hl=en&q=sony+4k+tv&sa=X&ved=2ahUKEwjl9uvRmJfmAhXkMn0KHR57Dj0Q_sUBKAIwIHoECBMQBA",
      "title": "Sony",
      "thumbnail": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRXa5XcW3uRgtmt7lrq25V5_oExB2NtVvDH3z2mKA5ZcH5G0nliTraVfAUhocTxPdwr4wNbQNFXlmAlQ5f9druNMKTkKIw7NjO5mJDjUU_SayxCDe49324a"
    },
    {
      "link": "https://www.google.com/search?gl=us&hl=en&q=tcl+4k+tv&sa=X&ved=2ahUKEwjl9uvRmJfmAhXkMn0KHR57Dj0Q_sUBKAMwIHoECBMQBQ",
      "title": "TCL",
      "thumbnail": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcQaV_u36jT2IPH9rfa1FzzigUW2wlZEgsz0DWXXvWZdBR5wmOJ7UrEkorwJtBnLvuJDOJg57bxbW-yk2EFIEdlkJbYPOuzDP3cnRgqGMoV3CkfVWQF06dk_"
    },
    ...
  ]
  ...
}

Refine by results for "ps4" in Japan

For non-english searches the result key would be "refine_by_item_types".

Refine by results for "ps4" in Japan

JSON Example

{
  ...
  "refine_by_item_types": [
    {
      "link": "https://www.google.co.jp/search?hl=ja&gl=jp&q=ps4+rpg&sa=X&ved=2ahUKEwjk19GjmrLmAhXMrVkKHexZBUgQ_sUBKAAwFnoECAwQAg",
      "title": "RPG",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcQ8iQT6rK4XQZgCLbuQ7l0EjwV7dTrXU-cevk93eFmBaRZQfSm1d5nKE2upC6_6lXAUGqts6fnuWX5izhMS5cyKbji8vIDZ0iulOSkrYGLRAxIdLWWM9yK4"
    },
    {
      "link": "https://www.google.co.jp/search?hl=ja&gl=jp&q=ps4+%E3%82%A2%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3&sa=X&ved=2ahUKEwjk19GjmrLmAhXMrVkKHexZBUgQ_sUBKAEwFnoECAwQAw",
      "title": "アクションゲーム",
      "thumbnail": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcTa-k7KjSvBaM0U4VoNJqscbGSw0yUewNR0HxVXxpTo8FgKeYNaI2kwhWlt2fyHqwu0gSPu9yZ9ksrSgc2KiLehY8uoGQFKRoiRxcdg-sQWt7fjWAuH1VZbz0c"
    },
    {
      "link": "https://www.google.co.jp/search?hl=ja&gl=jp&q=ps4+%E3%83%AC%E3%83%BC%E3%82%B9%E3%82%B2%E3%83%BC%E3%83%A0&sa=X&ved=2ahUKEwjk19GjmrLmAhXMrVkKHexZBUgQ_sUBKAIwFnoECAwQBA",
      "title": "レースゲーム",
      "thumbnail": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSFohK8834FD1hx7UO2XSz83Pyy6n6ynumnkY4LVrOyScyUuYeh4RKYLKptuQHKJSr7upOl87a2aUupDy4srQiNcfKh7fRwQX0WDaLhSqeXiPRkZ47_Dp6Q5A"
    },
    {
      "link": "https://www.google.co.jp/search?hl=ja&gl=jp&q=ps4+%E3%82%B7%E3%83%9F%E3%83%A5%E3%83%AC%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3&sa=X&ved=2ahUKEwjk19GjmrLmAhXMrVkKHexZBUgQ_sUBKAMwFnoECAwQBQ",
      "title": "シミュレーション",
      "thumbnail": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSeWoF0sJnut5SOWliR2NHAl_T0z8hy-jx-NLgaaKJMLyMkizZAjOE0zIWJSQHr2YPJVElmdS_SOCWyO2Jafpj0oHTRF5ybQs5WilFju3L1rjs-7BuJLGYldg"
    },
    ...
  ]
  ...
}