API Reference › Google › Organic results

Organic results

The unpaid, ranked web listings that Google returns for a query, each carrying its title, destination URL, snippet, and rank so you can reconstruct the natural search order programmatically.

POST https://api.cloro.cloud/v1/monitor-google

Overview

Organic results are the editorially-ranked, non-advertising listings that make up the main body of a Google search page. They are not fetched through a dedicated call: they arrive inside the payload of the Google Search endpoint, delivered as the organicResults array on the result object. To retrieve them, issue a request to the Google Search endpoint with the query you want to inspect, then read the array described below.

Request example

{
  "query": "best laptops for programming",
  "country": "US"
}

A successful call returns the standard response envelope; the organic listings are surfaced under result.organicResults.

Organic result fields

Field	Type	Description
`position`	number	Rank of the listing within the results, counted from 1 at the top.
`title`	string	Clickable headline shown for the listing.
`link`	string	Full destination URL the listing points to.
`displayedLink`	string	Human-readable URL shown beneath the title, formatted the way Google renders it.
`snippet`	string	Short descriptive excerpt Google displays under the listing.
`page`	number	Results page the listing was captured on, useful when spanning multiple pages.

Response example

{
  "success": true,
  "result": {
    "organicResults": [
      {
        "position": 1,
        "title": "Best Laptops for Programming in 2026",
        "link": "https://example.com/best-laptops-for-programming",
        "displayedLink": "example.com › best-laptops",
        "snippet": "We tested dozens of laptops, and these are the top picks for developers in 2026...",
        "page": 1
      },
      {
        "position": 2,
        "title": "Top 10 Developer Laptops Reviewed",
        "link": "https://example.com/dev-laptops-review",
        "displayedLink": "example.com › dev-laptops-review",
        "snippet": "An in-depth comparison of laptops for software developers.",
        "page": 1
      }
    ]
  }
}

Notes

The array preserves Google's ranking order, so iterating it top to bottom mirrors what a user sees on the page. When a query spans several result pages, the page field lets you tell which page each listing came from. For help integrating this data, reach us at [email protected].