Google Light Organic Results API

Google search main results are called organic results. Some results are simple and straightforward. Others include rich data like reviews, thumbnails, and other special snippets. SerpApi is able to scrape, extract, and make sense of both simple and more complex organic results.

When SerpApi encounters organic results, we add them to our JSON output as the array organic_results.

For each organic result, we are able to extract its position, title, link, redirect_link, displayed_link, thumbnail, date, snippet, sitelinks.inline, sitelinks.list, extensions, reviews, ratings, and more.

Example with q: Coffee

Example with q: Coffee

JSON Example

{
  "organic_results": [
    {
      "position": 1,
      "title": "Coffee - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Coffee",
      "displayed_link": "en.wikipedia.org › wiki › 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 ...",
      "sitelinks": {
        "inline": [
          {
            "title": "Coffee bean",
            "link": "https://en.wikipedia.org/wiki/Coffee_bean"
          },
          {
            "title": "History",
            "link": "https://en.wikipedia.org/wiki/History_of_coffee"
          },
          {
            "title": "Coffee production",
            "link": "https://en.wikipedia.org/wiki/Coffee_production"
          },
          {
            "title": "Coffee preparation",
            "link": "https://en.wikipedia.org/wiki/Coffee_preparation"
          }
        ]
      }
    },
    {
      "position": 2,
      "title": "What is Coffee? - National Coffee Association",
      "link": "https://www.ncausa.org/About-Coffee/What-is-Coffee",
      "displayed_link": "www.ncausa.org › About 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."
    },
    {
      "position": 3,
      "title": "Starbucks Coffee Company",
      "link": "https://www.starbucks.com/",
      "displayed_link": "www.starbucks.com",
      "snippet": "More than just great coffee. Explore the menu, sign up for Starbucks® Rewards, manage your gift card and more.",
      "sitelinks": {
        "inline": [
          {
            "title": "Let's talk coffee",
            "link": "https://www.starbucks.com/coffee/"
          },
          {
            "title": "Store Locator",
            "link": "https://www.starbucks.com/store-locator"
          },
          {
            "title": "Menu",
            "link": "https://www.starbucks.com/menu"
          },
          {
            "title": "Starbucks®️ Coffee",
            "link": "https://athome.starbucks.com/"
          }
        ]
      }
    },
    {
      "position": 4,
      "title": "Coffee | Origin, Types, Uses, History, & Facts | Britannica",
      "link": "https://www.britannica.com/topic/coffee",
      "displayed_link": "www.britannica.com › Entertainment & Pop Culture › Food",
      "snippet": "Coffee, beverage brewed from the roasted and ground seeds of the tropical evergreen coffee plant of African origin. Coffee is one of the ...",
      "sitelinks": {
        "inline": [
          {
            "title": "Using coffee",
            "link": "https://www.britannica.com/topic/coffee/Using-coffee"
          },
          {
            "title": "History of coffee",
            "link": "https://www.britannica.com/topic/history-of-coffee"
          },
          {
            "title": "Drip coffee",
            "link": "https://www.britannica.com/topic/drip-coffee"
          },
          {
            "title": "Decaffeinated coffee",
            "link": "https://www.britannica.com/topic/decaffeinated-coffee"
          }
        ]
      },
      "date": "7 days ago"
    },
    ...
  ],
}

Example with q: Iphone 15

Example with q: Iphone 15

JSON Example

{
  "organic_results": [
    {
      "position": 1,
      "title": "iPhone 15 and iPhone 15 Plus - Apple",
      "link": "https://www.apple.com/iphone-15/",
      "displayed_link": "www.apple.com › iphone-15",
      "snippet": "Keep exploring iPhone. · iPhone 15. Available in Pink, Yellow, Green, Blue, and Black. From $799 or $33.29/mo. for 24 mo. Currently viewingiPhone 15 Buy. A16 ...",
      "sitelinks": {
        "list": [
          {
            "title": "Buy",
            "link": "https://www.apple.com/shop/buy-iphone/iphone-15"
          },
          {
            "title": "iPhone 15 Pro",
            "link": "https://www.apple.com/iphone-15-pro/"
          },
          {
            "title": "Tech specs",
            "link": "https://www.apple.com/iphone-15/specs/"
          },
          {
            "title": "Buy iPhone 15 Pro",
            "link": "https://www.apple.com/shop/buy-iphone/iphone-15-pro"
          }
        ]
      }
    },
    {
      "position": 2,
      "title": "New Apple iPhone 15 5G - T-Mobile",
      "link": "https://www.t-mobile.com/cell-phone/apple-iphone-15",
      "displayed_link": "www.t-mobile.com › Phones › Apple",
      "snippet": "iPhone 15 brings you Dynamic Island, a 48MP Main camera, and USB-C—all in a durable color-infused glass and aluminum design. Need help with choosing which ...",
      "extensions": [
        "Rating",
        "3.6 (15)",
        "$34.59 to $1,129.99",
        "In stock"
      ],
      "rating": 3.6,
      "reviews": 15
    },
    ...
  ],
}

Example with q: Coffee video

Example with q: Coffee video

JSON Example

{
  "organic_results": [
    {
      "position": 1,
      "title": "Free Coffee Videos - Pexels",
      "link": "https://www.pexels.com/search/videos/coffee/",
      "displayed_link": "www.pexels.com › search › coffee",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGuvzTCQ9HqjWnvb3PINpGP7YbIzztHhyQqzPuLdTJTBHbuejtrx45Qw8&s",
      "snippet": "Download and use 7519+ Coffee stock videos for free. ✓ Thousands of new 4k videos every day ✓ Completely Free to Use ✓ High-quality HD videos and clips ..."
    },
    {
      "position": 2,
      "title": "How To Make Every Coffee Drink | Method Mastery | Epicurious",
      "link": "https://m.youtube.com/watch?v=lVeNTofDB2k",
      "displayed_link": "m.youtube.com › watch",
      "thumbnail": "https://i.ytimg.com/vi/lVeNTofDB2k/default.jpg?sqp=-oaymwEECHgQQw&rs=AMzJL3lSlq64dtssIyVcHi6Ow2I5Vle1rA",
      "duration": "34:08",
      "date": "Sep 28, 2020"
    },
    ...
  ],
}

Example with missing and must_include sections

Example with missing and must_include sections

JSON Example

{
  "organic_results": [
    ...
    {
      "position": 6,
      "title": "Bondestudentar (utdrag) - Norsk - NDLA",
      "link": "https://ndla.no/subject:af91136f-7da8-4cf1-b0ba-0ea6acdf1489/topic:0933e7b2-45fb-4e7f-bb13-64d7c2cd5da3/topic:26185e28-77f4-4daa-9638-5cc15912048a/topic:2c3e1155-6934-4474-905d-3c9e245c04fa/topic:68b6f796-5bbb-4069-8982-c624e533a1d0/resource:028c4080-2565-4bc6-94a3-2f425b8c9367",
      "displayed_link": "ndla.no › ... › Realisme › Kritisk realisme og naturalisme",
      "snippet": "Et utdrag fra Arne Garborgs roman Bondestudentar ... I dette utdraget skildrer Garborg hvordan ... Sammenlign hvordan eldre og nyere tekster ...",
      "date": "Jan 27, 2022",
      "missing": [
        "Rådebank"
      ],
      "must_include": {
        "word": "Rådebank",
        "link": "https://www.google.com/search?num=12&sca_esv=64731a106f604e99&sca_upv=1&gbv=1&hl=en&gl=us&q=Hvordan+sammenligne+Arne+Garborgs+Bondestudentar+og+%22R%C3%A5debank%22&sa=X&ved=2ahUKEwjhpPqsy5SGAxUJvokEHfrLA5EQ5t4CegQIARAG"
      }
    },
    {
      "position": 7,
      "title": "Kontakt Påbygg (LK20) by Cappelen Damm - Issuu",
      "link": "https://issuu.com/cdundervisning/docs/kontakt_p_bygg_lk20_blaibok",
      "displayed_link": "issuu.com › cdundervisning › docs › kontakt_p_bygg_lk20_blaibok",
      "snippet": "Arne Garborg skrev i 1903 at ung ikke kan lære av gammel. Det er jo litt meg, det. Det er jeg som er barnet, og mine suksessfulle venner representerer den eldre ..."
    },
    {
      "position": 8,
      "title": "[PDF] Norske klassikere - Brage INN",
      "link": "https://brage.inn.no/inn-xmlui/bitstream/handle/11250/134062/rapp16_2003.pdf?sequence=1&isAllowed=y",
      "displayed_link": "brage.inn.no › inn-xmlui › bitstream › handle › rapp16_2003",
      "snippet": "Hulda Garborg, Hans. Aanrud og Åsmund Sveen er alle forfattere som – på ulike måter og av ulike grunner – har fristet tilværelsen litt i utkanten av det ..."
    },
    ...
  ],
}

Organic Results State

SerpApi recognizes different states of organic results and adds it to search_information.organic_results_state.

There are five possible states:

  • • Results for exact spelling
  • • Some results for exact spelling but showing fixed spelling
  • • Showing results for exact spelling despite spelling suggestion
  • • Fully empty

Results for exact spelling: Regular Google search results page without query corrections

Results for exact spelling: Regular Google search results page without query corrections

JSON Example

{
  "search_information": {
    "organic_results_state": "Results for exact spelling",
    ...
  }
}

Results for: Coffeee

Results for: Coffeee

JSON Example

{
  "search_information": {
    "organic_results_state": "Some results for exact spelling but showing fixed spelling",
    ...
  }
}

Results for: Cofee

Results for: Cofee

JSON Example

{
  "search_information": {
    "organic_results_state": "Showing results for exact spelling despite spelling suggestion",
    ...
  }
}

Fully empty: No organic results

Fully empty: No organic results

JSON Example

{
  "search_information": {
    "organic_results_state": "Fully empty",
    ...
  }
}

JSON structure overview

{
  "organic_results": [
    {
      "position": "Integer - Position of the organic result on the search page",
      "title": "String - Title of the organic result",
      "link": "String - Link of the organic result",
      "redirect_link": "String - Redirect link of the organic result",
      "displayed_link": "String - Displayed link of the organic result",
      "thumbnail": "String - Thumbnail of the organic result",
      "date": "String - Date of the organic result",
      "snippet": "String - Snippet of the organic result",
      "duration": "String - Duration of the organic result - video result",
      "sitelinks": {
        "inline": [
          {
            "title": "String - Title of the inline sitelink",
            "link": "String - Link of the inline sitelink"
          },
        ],
        "list": [
          {
            "title": "String - Title of the list sitelink",
            "link": "String - Link of the list sitelink",
          },
        ]
      },
      "extensions": [
        "String - Extension of the rich snippet top",
      ],
      "rating": "Float - Item rating",
      "reviews": "Integer - Number of reviews"
    },
  ],
}