Verticals

search -v/--vertical switches the Google tab. Each vertical has its own extractor and its own output shape. The default is web; the other five return their results under vertical_results in the JSON.

gsearch search "cats" -v images
gsearch search "python tutorial" -v videos
gsearch search "climate change" -v news
gsearch search "running shoes" -v shopping
gsearch search "python programming" -v books

web (default)

The full web results page: the rich feature blocks (knowledge panel, weather, sports, and the rest) plus the organic results, People Also Ask, related searches, and top stories. This is the vertical the searching guide covers in depth. It does not use vertical_results; its data lives in features, organic_results, and the top-level lists.

images

Image cards with their source site, dimensions, and thumbnail:

gsearch search "golden gate bridge" -v images

Image Results (48)
   1. Golden Gate Bridge at sunset  nps.gov  [1920x1080]
   2. Aerial view of the bridge     wikipedia.org  [2400x1600]
   ...
  related: golden gate park | san francisco | suspension bridge

vertical_results carries images (a list of cards with title, site, width, height, and the thumbnail), a count, and a related_searches list.

videos

Video results with channel, duration, views, and date:

gsearch search "python tutorial" -v videos

Video Results (15)
  1. Python Full Course for Beginners
     freeCodeCamp.org  |  4:26:52  |  39M views  |  2 years ago  |  YouTube
  ...

vertical_results carries videos (each with position, title, url, channel, duration, views, date, platform) and a count.

news

Articles and top-stories clusters:

gsearch search "climate change" -v news

News Results (20)
  Top stories:
    • UN warns on emissions gap  Reuters · 3 hours ago
  • Major report on warming released  AP · 5 hours ago
     A new assessment finds...
  ...

vertical_results carries articles (with title, url, source, date, snippet), an optional top_stories list, and a count.

shopping

Products with price, store, rating, and delivery:

gsearch search "running shoes" -v shopping

Shopping Results (15)
  1. Nike Pegasus 41 Running Shoes
     $129.99  |  Nike  |  Free delivery  rating:4.7
  ...

vertical_results carries products (with position, title, price, store, rating, delivery), an optional sidebar_filters map, and a count.

books

Books with author, year, rating, and publisher:

gsearch search "python programming" -v books

Book Results (12)
  1. Fluent Python
     Luciano Ramalho  |  2022  rating:4.6
  ...

vertical_results carries books (with position, title, url, author, year, rating) and a count.

The vertical_results shape

For any non-web vertical, the result object adds a vertical_results object and sets vertical to the tab you chose. The inner key names the result list (images, videos, articles, products, or books), and most verticals add a count and a search_tools block describing the active filters. The web blocks (features, organic_results) are not populated in a non-web vertical; read vertical_results instead.

To get the raw list as JSON, combine -v with --json:

gsearch search "running shoes" -v shopping --json | jq '.vertical_results.products'