gsc

A site's distinct Search Console queries per day

Per day over range, how many distinct queries a site's Search Console property showed for, how many of them earned a click, and how many ranked 1 to 3, 4 to 10, 11 to 20 and 21+ (bands), from the data Frontshelf stores; filter narrows the queries counted. The counts are of Google's observed rows, so they are floors, and coverage says which days are missing, provisional or capped: a missing day is absent, never 0. Free (query_counts). Next: gsc_table_get with dimension query for the queries themselves.

get/v1/sites/{site}/search/query-counts

Request

  • Base URL: https://frontshelf.io/api
  • URL: https://frontshelf.io/api/v1/sites/{site}/search/query-counts
  • Auth: HTTP bearer

Path parameters

sitestring required

Site ID (site_…), origin (https://example.com), or bare domain, resolved server-side; the response carries the canonical ID.

Query parameters

source_idstring

One of the site's Search Console properties (ssrc_…, from gsc_sources_list). Omit for the site's primary property.

type'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews'

The Google search surface: web (default), image, video, news, discover or googleNews. Discover and Google News have no query dimension and no position.

string
OR
OR
OR
string
OR
OR
OR
brand'branded' | 'non_branded'
presetsstring[]
daily_position_maxnumber
saved_filter_idstring

A saved filter (ssf_…, from gsc_filters_list) applied on top of filter; a cursor read under it expires when the filter is edited.

Response

A site's distinct Search Console queries per day

summarystring required

The answer in one or two sentences, with the numbers it rests on.

warningsstring[] required

What limits this answer (a cap, a read that was cut short). Empty when nothing does.

site_idstring required

The site's canonical id.

source_idstring required

The property the figures are from (ssrc_…).

Changes

No recorded changes to this operation across all 1 revision of this API.