# gsc_find_losses_gains

> Compare two periods for query or page performance and return click/impression/CTR/position deltas.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Search Console](https://www.getmcpads.com/docs/sources/search-console)

Compare two periods for query or page performance and return click/impression/CTR/position deltas.

|  |  |
| --- | --- |
| Source | [Search Console](https://www.getmcpads.com/docs/sources/search-console) |
| Kind | Read |
| Discovery | Announced in the tool list |
| Account parameter | `siteUrl` |
| Endpoint | https://mcp.getmcpads.com/search-console/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `siteUrl` | string | Optional | Search Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted. |
| `dimension` | string | Optional | One of: `query`, `page`. Default: `"query"`. |
| `searchType` | string | Optional | One of: `web`, `image`, `video`, `news`, `discover`, `googleNews`. Default: `"web"`. |
| `datePreset` | string | Optional | One of: `today`, `yesterday`, `last7days`, `last28days`, `last3months`, `last6months`, `last12months`, `last16months`. Default: `"last28days"`. |
| `currentDateRange` | object | Optional | Current period. Defaults to datePreset. |
| `previousDateRange` | object | Optional | Previous period. Defaults to the immediately preceding period with the same length. |
| `limit` | integer | Optional | Rows to fetch for each period. Default: `5000`. |
| `topN` | integer | Optional | Default: `25`. |
| `minAbsClickDelta` | number | Optional | Filter out rows with smaller absolute click delta. Default: `0`. |
| `sortBy` | string | Optional | One of: `clicksDelta`, `impressionsDelta`, `ctrDelta`, `positionDelta`. Default: `"clicksDelta"`. |

## Calling it

Directly, since it is announced

```json
{
  "name": "gsc_find_losses_gains",
  "arguments": {}
}
```

- [Search Console metrics](https://www.getmcpads.com/docs/sources/search-console/metrics): What you can ask for.
- [Search Console dimensions](https://www.getmcpads.com/docs/sources/search-console/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/search-console/tools/gsc_find_losses_gains
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.