---
title: "Get GSC performance report"
method: GET
path: "/api/agent/gsc/report"
tags: ["GSC"]
---

# Get GSC performance report

`GET /api/agent/gsc/report`

Returns Google Search Console performance report with clicks, impressions, CTR, positions, top queries, top pages, movers, opportunities, and article suggestions. Returns connect URL if GSC is not linked. Free (0 credits).

## Query parameters

- `force_refresh` boolean

## Response `200`

GSC report (connected) or connect URL (not connected)

- union
  - object
    - `connected` true, required
    - `cached` boolean
    - `reportDate` string, date, required
    - `gscProperty` string
    - `rangeDays` integer
    - `summary` object, required
      - `clicks` integer
      - `impressions` integer
      - `ctr` number
      - `position` number
      - `clicksChangePct` number, nullable
      - `impressionsChangePct` number, nullable
    - `topQueries` object[]
      - `query` string
      - `clicks` integer
      - `impressions` integer
      - `ctr` number
      - `position` number
    - `topPages` object[]
      - `page` string
      - `clicks` integer
      - `impressions` integer
      - `ctr` number
      - `position` number
    - `movers` object
      - `gainers` object[]
      - `losers` object[]
    - `opportunities` object[]
    - `articleSuggestions` object[]
      - `keyword` string
      - `reason` string
      - `impressions` integer
      - `position` number
      - `opportunityScore` number
      - `workflow` string
  - object
    - `connected` false, required
    - `connect_url` string, uri, required
    - `message` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate limit exceeded
- `500` — Internal server error

## Changes

- **2026-03-28** `1cbb3a513b7f` — 1 breaking
  - the `oneOf[subschema #1]/articleSuggestions/items/opportunityScore` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
- **2026-03-28** `86cc79b6b357` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/citedy/apis/citedy-agent-api/changes/api/agent/gsc/report/get.md)

---

[API](https://skmtc.dev/citedy/apis/citedy-agent-api.md) · [All operations](https://skmtc.dev/citedy/apis/citedy-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/citedy/citedy-agent-api/revisions/b5785d3fe446/schema)