JSON Restrictor

Restrict your response to the fields you need for smaller, faster results and more efficient client-side parsing.

We support passing a json_restrictor parameter for all engines.

Examples

Select only organic_results.

json_restrictor: organic_results

Try this search

{
  "organic_results": [
    {
      "position": 1,
      "title": "Coffee",
      "link": "https://en.wikipedia.org/wiki/Coffee",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://en.wikipedia.org/wiki/Coffee&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECBYQAQ",
      "displayed_link": "https://en.wikipedia.org › wiki › Coffee",
      "thumbnail": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb88a98ec4c675f61ce03c54738029e1ddf1.jpeg",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb8823e8aa311d084504da1d564ee496ea28.webp",
      "snippet": "Coffee is a beverage brewed from roasted coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily due ...",
      "snippet_highlighted_words": [
        "Coffee",
        "coffee",
        "coffee"
      ],
      "source": "Wikipedia"
    },
    {
      "position": 2,
      "title": "Blue Bottle Coffee | Fresh Roasted Specialty Coffee",
      "link": "https://bluebottlecoffee.com/?srsltid=AfmBOopDNlGMg82-zZfh6GfH_-xNWkFr8B0EqfxsZhUO1QVzX407FhtL",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://bluebottlecoffee.com/%3Fsrsltid%3DAfmBOopDNlGMg82-zZfh6GfH_-xNWkFr8B0EqfxsZhUO1QVzX407FhtL&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECEAQAQ",
      "displayed_link": "https://bluebottlecoffee.com",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSaCUz1RgG8lWzRn0Q8hN7HDgMIlAU_ygcpAdWt9A47lhya0dSSi95j&usqp=CAE&s",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb889ed5a47648013ec7823e5ec6b5305c6c.webp",
      "snippet": "Blue Bottle Coffee is a specialty coffee roaster with cafes in LA, SF, NYC, & Japan. Shop our freshly roasted specialty coffee online & in-store.",
      "snippet_highlighted_words": [
        "Coffee",
        "coffee",
        "coffee"
      ],
      "rich_snippet": {
        "top": {
          "detected_extensions": {
            "price": 2,
            "currency": "Free – day delivery over $",
            "unknown": 30
          },
          "extensions": [
            "Free 2–6 day delivery over $40",
            "‎30",
            "day returns"
          ]
        }
      },
      "source": "Blue Bottle Coffee"
    },
    {
      "position": 3,
      "title": "Peet's Coffee | The Original Craft Coffee, Est. 1966",
      "link": "https://www.peets.com/",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://www.peets.com/&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECDYQAQ",
      "displayed_link": "https://www.peets.com",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT-gdff_D45IrKroGT_zvxB4r2Xjs7sf-Hahg5YIgzmuu3mr5Vaf-OC&usqp=CAE&s",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb885e78ccd85bd0f277eb6e62667ba9c873.webp",
      "snippet": "Since 1966, Peet's Coffee has sourced and offered superior coffees and teas and adhering to strict high-quality and taste standards. Shop today.",
      "snippet_highlighted_words": [
        "Coffee",
        "coffees"
      ],
      "source": "Peet's Coffee"
    },
    {
      "position": 4,
      "title": "Organic Whole Bean Coffee | Shop for Fresh ...",
      "link": "https://puritycoffee.com/collections/whole-bean-coffee?srsltid=AfmBOooHdwxYFmkoAfXMujwc1cW5sgsvw8SFGCPnGU_hkF_CAMyXQJJs",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://puritycoffee.com/collections/whole-bean-coffee%3Fsrsltid%3DAfmBOooHdwxYFmkoAfXMujwc1cW5sgsvw8SFGCPnGU_hkF_CAMyXQJJs&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECG8QAQ",
      "displayed_link": "https://puritycoffee.com › collections › whole-bean-coffee",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTQSRIyWslKiByscJUjuLfTEQEgD2xGiFZad1-SxPFgxxjbYYC9Y28Q&usqp=CAE&s",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb88f3f9dbf0efd0cda5b61651281a3f348d.webp",
      "snippet": "We've created a specialty-grade, antioxidant-rich whole bean organic coffee that emphasizes how you feel rather than just how caffeinated you can get.",
      "snippet_highlighted_words": [
        "coffee"
      ],
      "rich_snippet": {
        "top": {
          "detected_extensions": {
            "store_rating_k": 4.9,
            "price": 6,
            "currency": "Free – day delivery over $",
            "unknown": 30
          },
          "extensions": [
            "4.9store rating (17K)",
            "‎$16 to $162",
            "‎Free 6–7 day delivery over $57.51",
            "‎30",
            "day returns"
          ]
        }
      },
      "source": "Purity Coffee"
    },
    {
      "position": 5,
      "title": "Starbucks Coffee Company",
      "link": "https://www.starbucks.com/",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://www.starbucks.com/&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECF4QAQ",
      "displayed_link": "https://www.starbucks.com",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb884e14e8be51b2b0a650ed0084d45824d3.webp",
      "snippet": "More than just great coffee. Explore the menu, sign up for Starbucks® Rewards, manage your gift card and more.",
      "snippet_highlighted_words": [
        "coffee"
      ],
      "source": "Starbucks"
    },
    {
      "position": 6,
      "title": "r/Coffee",
      "link": "https://www.reddit.com/r/Coffee/",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://www.reddit.com/r/Coffee/&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECDwQAQ",
      "displayed_link": "2.1M+ followers",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb88cc0af4c0a718396428fbc34ea8f229b9.webp",
      "snippet": "thread where you can share what you are brewing or ask for bean recommendations. This is a place to share and talk about your favorite coffee roasters or beans.",
      "snippet_highlighted_words": [
        "coffee"
      ],
      "sitelinks": {
        "list": [
          {
            "title": "Local Coffee Roaster? : r/ithaca",
            "link": "https://www.reddit.com/r/ithaca/comments/1fotncw/local_coffee_roaster/",
            "date": "an hour ago"
          },
          {
            "title": "Best Coffee Spot : r/austinfood",
            "link": "https://www.reddit.com/r/austinfood/comments/1fnv9au/best_coffee_spot/",
            "date": "Sep 23, 2024"
          },
          {
            "title": "ISO best coffee shop in Manhattan where you can buy ...",
            "link": "https://www.reddit.com/r/FoodNYC/comments/1fntnij/iso_best_coffee_shop_in_manhattan_where_you_can/",
            "date": "Sep 23, 2024"
          }
        ]
      },
      "source": "Reddit · r/Coffee"
    },
    {
      "position": 7,
      "title": "What is Coffee?",
      "link": "https://www.ncausa.org/About-Coffee/What-is-Coffee",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://www.ncausa.org/About-Coffee/What-is-Coffee&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECDcQAQ",
      "displayed_link": "https://www.ncausa.org › About Coffee",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTp9mGEiLrFPJTDgxbtySMTOc3UNvBpZhZ7IzhkzBRVYS-CBxbj9EVa&usqp=CAE&s",
      "snippet": "Coffee traces its origin to a genus of plants known as Coffea. Within the genus there are over 500 genera and 6,000 species of tropical trees and shrubs.",
      "snippet_highlighted_words": [
        "Coffee"
      ],
      "source": "National Coffee Association"
    },
    {
      "position": 8,
      "title": "Specialty Coffee | Wonderstate",
      "link": "https://wonderstate.com/?srsltid=AfmBOorXmqKTPUvW0mOV9wztLeDREYbcs60mvVqkLY-BD0UAfezbdmCO",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://wonderstate.com/%3Fsrsltid%3DAfmBOorXmqKTPUvW0mOV9wztLeDREYbcs60mvVqkLY-BD0UAfezbdmCO&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECDsQAQ",
      "displayed_link": "https://wonderstate.com",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT-7ZGtnv23Q3Oc8mVFmx10i-G4GH4anTVl1hVpyRcuc21emi-9CgRx&usqp=CAE&s",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb88e6c21911d8af9d1e7060e7bdacb3cd1f.webp",
      "snippet": "Award-winning, organic coffee roasters in Wisconsin. 100% solar powered. Paying farmers more with a minimum price guarantee that's double the Fair Trade ...",
      "snippet_highlighted_words": [
        "coffee"
      ],
      "rich_snippet": {
        "top": {
          "detected_extensions": {
            "price": 4,
            "currency": "Free – day delivery over $",
            "unknown": 30
          },
          "extensions": [
            "Free 4–7 day delivery over $50",
            "‎30",
            "day returns"
          ]
        }
      },
      "source": "Wonderstate Coffee"
    }
  ]
}
Select local_map and the first result of organic_results.

json_restrictor: local_map, organic_results[0]

Try this search

{
  "local_map": {
    "link": "https://www.google.com/search?sca_esv=c739495d99abe72c&sca_upv=1&gl=us&hl=en&q=Coffee&npsic=0&rflfq=1&rldoc=1&rllag=30287342,-97735387,3628&tbm=lcl&sa=X&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQtgN6BAguEAE",
    "image": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/1440a5ac62d0aa27110540efeda04a8a.png",
    "gps_coordinates": {
      "latitude": 30.287342,
      "longitude": -97.735387
    }
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Coffee",
      "link": "https://en.wikipedia.org/wiki/Coffee",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://en.wikipedia.org/wiki/Coffee&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECBYQAQ",
      "displayed_link": "https://en.wikipedia.org › wiki › Coffee",
      "thumbnail": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb88a98ec4c675f61ce03c54738029e1ddf1.jpeg",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb8823e8aa311d084504da1d564ee496ea28.webp",
      "snippet": "Coffee is a beverage brewed from roasted coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily due ...",
      "snippet_highlighted_words": [
        "Coffee",
        "coffee",
        "coffee"
      ],
      "source": "Wikipedia"
    }
  ]
}
Select the first three results of organic_results.

json_restrictor: organic_results[0:3]

Try this search

{
  "organic_results": [
    {
      "position": 1,
      "title": "Coffee",
      "link": "https://en.wikipedia.org/wiki/Coffee",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://en.wikipedia.org/wiki/Coffee&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECBYQAQ",
      "displayed_link": "https://en.wikipedia.org › wiki › Coffee",
      "thumbnail": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb88a98ec4c675f61ce03c54738029e1ddf1.jpeg",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb8823e8aa311d084504da1d564ee496ea28.webp",
      "snippet": "Coffee is a beverage brewed from roasted coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily due ...",
      "snippet_highlighted_words": [
        "Coffee",
        "coffee",
        "coffee"
      ],
      "source": "Wikipedia"
    },
    {
      "position": 2,
      "title": "Blue Bottle Coffee | Fresh Roasted Specialty Coffee",
      "link": "https://bluebottlecoffee.com/?srsltid=AfmBOopDNlGMg82-zZfh6GfH_-xNWkFr8B0EqfxsZhUO1QVzX407FhtL",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://bluebottlecoffee.com/%3Fsrsltid%3DAfmBOopDNlGMg82-zZfh6GfH_-xNWkFr8B0EqfxsZhUO1QVzX407FhtL&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECEAQAQ",
      "displayed_link": "https://bluebottlecoffee.com",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSaCUz1RgG8lWzRn0Q8hN7HDgMIlAU_ygcpAdWt9A47lhya0dSSi95j&usqp=CAE&s",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb889ed5a47648013ec7823e5ec6b5305c6c.webp",
      "snippet": "Blue Bottle Coffee is a specialty coffee roaster with cafes in LA, SF, NYC, & Japan. Shop our freshly roasted specialty coffee online & in-store.",
      "snippet_highlighted_words": [
        "Coffee",
        "coffee",
        "coffee"
      ],
      "rich_snippet": {
        "top": {
          "detected_extensions": {
            "price": 2,
            "currency": "Free – day delivery over $",
            "unknown": 30
          },
          "extensions": [
            "Free 2–6 day delivery over $40",
            "‎30",
            "day returns"
          ]
        }
      },
      "source": "Blue Bottle Coffee"
    },
    {
      "position": 3,
      "title": "Peet's Coffee | The Original Craft Coffee, Est. 1966",
      "link": "https://www.peets.com/",
      "redirect_link": "https://www.google.com/url?sa=t&source=web&rct=j&opi=89978449&url=https://www.peets.com/&ved=2ahUKEwioqfKjst2IAxU4MVkFHXHuMmQQFnoECDYQAQ",
      "displayed_link": "https://www.peets.com",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT-gdff_D45IrKroGT_zvxB4r2Xjs7sf-Hahg5YIgzmuu3mr5Vaf-OC&usqp=CAE&s",
      "favicon": "https://serpapi.com/searches/66f3a3b0922cce80bbafc18e/images/7f2b8526c2e58d1269c65867e14ccb885e78ccd85bd0f277eb6e62667ba9c873.webp",
      "snippet": "Since 1966, Peet's Coffee has sourced and offered superior coffees and teas and adhering to strict high-quality and taste standards. Shop today.",
      "snippet_highlighted_words": [
        "Coffee",
        "coffees"
      ],
      "source": "Peet's Coffee"
    }
  ]
}
Select organic_results with only title of each result.

json_restrictor: organic_results[].title

Try this search

{
  "organic_results": [
    {
      "title": "Coffee"
    },
    {
      "title": "Blue Bottle Coffee | Fresh Roasted Specialty Coffee"
    },
    {
      "title": "Peet's Coffee | The Original Craft Coffee, Est. 1966"
    },
    {
      "title": "Organic Whole Bean Coffee | Shop for Fresh ..."
    },
    {
      "title": "Starbucks Coffee Company"
    },
    {
      "title": "r/Coffee"
    },
    {
      "title": "What is Coffee?"
    },
    {
      "title": "Specialty Coffee | Wonderstate"
    }
  ]
}
Select organic_results with title and snippet of each result.

json_restrictor: organic_results[].{title, snippet}

Try this search

{
  "organic_results": [
    {
      "title": "Coffee",
      "snippet": "Coffee is a beverage brewed from roasted coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans, primarily due ..."
    }
    {
      "title": "Blue Bottle Coffee | Fresh Roasted Specialty Coffee",
      "snippet": "Blue Bottle Coffee is a specialty coffee roaster with cafes in LA, SF, NYC, & Japan. Shop our freshly roasted specialty coffee online & in-store."
    }
    {
      "title": "Peet's Coffee | The Original Craft Coffee, Est. 1966",
      "snippet": "Since 1966, Peet's Coffee has sourced and offered superior coffees and teas and adhering to strict high-quality and taste standards. Shop today."
    }
    {
      "title": "Organic Whole Bean Coffee | Shop for Fresh ...",
      "snippet": "We've created a specialty-grade, antioxidant-rich whole bean organic coffee that emphasizes how you feel rather than just how caffeinated you can get."
    }
    {
      "title": "Starbucks Coffee Company",
      "snippet": "More than just great coffee. Explore the menu, sign up for Starbucks® Rewards, manage your gift card and more."
    }
    {
      "title": "r/Coffee",
      "snippet": "thread where you can share what you are brewing or ask for bean recommendations. This is a place to share and talk about your favorite coffee roasters or beans."
    }
    {
      "title": "What is Coffee?",
      "snippet": "Coffee traces its origin to a genus of plants known as Coffea. Within the genus there are over 500 genera and 6,000 species of tropical trees and shrubs."
    }
    {
      "title": "Specialty Coffee | Wonderstate",
      "snippet": "Award-winning, organic coffee roasters in Wisconsin. 100% solar powered. Paying farmers more with a minimum price guarantee that's double the Fair Trade ..."
    }
  ]
}
Select organic_results with title and links of sitelinks.inline.

json_restrictor: organic_results[].{title, sitelinks.inline[].link}

Try this search

{
  "organic_results": [
    {
      "title": "Coffee",
      "sitelinks": {
        "inline": [
          {
            "link": "https://en.wikipedia.org/wiki/History_of_coffee"
          },
          {
            "link": "https://en.wikipedia.org/wiki/Coffee_bean"
          },
          {
            "link": "https://en.wikipedia.org/wiki/Coffee_preparation"
          },
          {
            "link": "https://en.wikipedia.org/wiki/Coffee_production"
          }
        ]
      }
    },
    {
      "title": "Peet's Coffee | The Original Craft Coffee, Est. 1966"
    },
    {
      "title": "What is Coffee?"
    },
    {
      "title": "r/Coffee"
    },
    {
      "title": "Starbucks Coffee Company"
    },
    {
      "title": "coffee brand coffee: premium fresh roasted coffee",
      "sitelinks": {
        "inline": [
          {
            "link": "https://coffeebrandcoffee.com/collections/coffee"
          },
          {
            "link": "https://coffeebrandcoffee.com/products/003"
          },
          {
            "link": "https://coffeebrandcoffee.com/products/004"
          },
          {
            "link": "https://coffeebrandcoffee.com/collections/all"
          }
        ]
      }
    },
    {
      "title": "Counter Culture Coffee",
      "sitelinks": {
        "inline": [
          {
            "link": "https://counterculturecoffee.com/pages/training-centers"
          },
          {
            "link": "https://counterculturecoffee.com/pages/history"
          },
          {
            "link": "https://counterculturecoffee.com/pages/on-going-subscription"
          },
          {
            "link": "https://counterculturecoffee.com/collections/all"
          }
        ]
      }
    },
    {
      "title": "Coffee drinkers reap health boost – but only if they do it in ..."
    },
    {
      "title": "The Coffee Bean & Tea Leaf | CBTL"
    }
  ]
}

Operators

Operator Example Description
Object index: .<string> foo.bar Select the field bar of the object foo.
Array index: [<number>] foo[0] Select the first item of the array foo.
Select full array: [] foo[] Select all items of the array foo.
Array slice: [<range-start>:<range-end>] foo[0:2] Select the first two items of the array foo.
This is a half-open range, meaning it includes the first index but not the last.
Subquery: .{query1, query2, ...} foo.{bar, baz[].qux} Select the fields bar and baz of the object foo, and further select only qux of the array baz.
A query can be any valid combination of the operators.