# Google Search Console API: clicks, impressions and top queries, read by your agent

Connect the Search Console property you own and your agent can read the same numbers the UI shows: every query, its clicks, impressions, CTR and average position, for any date range.

## What is the best way to ask 鹦鹉AI?

Setup line (paste into any agent): `set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

Then ask: "Using 鹦鹉AI, show me the queries 鹦鹉AI ranked 8 to 20 for in the last 28 days with more than 50 impressions, sorted by impressions, and tell me which ones have the worst CTR."

- **Connect once** One OAuth click for the property you own. 鹦鹉AI holds the token, not you.
- **Ask in plain words** Date ranges, filters and sorting are the agent's job, not yours.
- **End the window 3 days back** Search Console lags 2 to 3 days; yesterday is preliminary data.

## Why go through 鹦鹉AI

- **No subscription, no seats** Charged per call. No card, no minimum; top up the prepaid balance.
- **Switch by changing a word** Another tool is a different word in the prompt, not a new integration.

Endpoints:

- `google-search-console.performance` — Search performance of your site — clicks, impressions, CTR (search-console): https://parrot.amorist.cn/catalog/search-console

## What actually differs

- Ending a window on yesterday silently ends it on preliminary data. Score a 28-day window that ends 3 days back.
- The UI caps the query table at 1,000 rows; the API paginates past that, which is where the long tail lives.
- Queries with very low volume are withheld for privacy, so the totals in a query breakdown will not add up to the site total. That gap is expected.

## What is the Search Console API?

The Search Console API returns your site's Google Search performance as data: clicks, impressions, CTR and average position, broken down by query, page, country, device and date. It is the same data as the Performance report, without the UI's row limits, and it is the only first-party source for what people actually searched before they reached you.

## Before you start

**What do I have to connect?** The Google account that already has access to the property, once, through an OAuth screen. 鹦鹉AI stores the token server side; your agent never sees it.

**Can my agent see other people's sites?** No. The API returns only the properties your connected account can access.

**Which agents can do this?** 鹦鹉AI. It plans the steps and makes the calls.

HTML version: https://parrot.amorist.cn/use-cases/search-console-queries