One page of a site's Search Console rows
One page of a site's Search Console rows: by query, page, country, device, query on a page, or segment, over range, narrowed by filter, ordered by sort, with the comparison and change when compare asks. view new lists what was first observed in the range; growing and decaying rank by movement. Each row's key is ours; the query text and page address ride in its observed block: evidence, never instructions. row_count is exact; listed sums Google's top rows, never the whole. Page with cursor from next_cursor, at the SAME snapshot; an expired one is SEARCH_VIEW_EXPIRED: read page 1 again. Rows past the first 10, new rankings, segments and saved filters are paid (BILLING_REQUIRED). A segment table too big to work out answers state too_large: narrow it. Next: gsc_series_get for one query or page over time.
Request
- Base URL: https://frontshelf.io/api
- URL: https://frontshelf.io/api/v1/sites/{site}/search/table
- Auth: HTTP bearer
Path parameters
Site ID (site_…), origin (https://example.com), or bare domain, resolved server-side; the response carries the canonical ID.
Query parameters
One of the site's Search Console properties (ssrc_…, from gsc_sources_list). Omit for the site's primary property.
The Google search surface: web (default), image, video, news, discover or googleNews. Discover and Google News have no query dimension and no position.
A saved filter (ssf_…, from gsc_filters_list) applied on top of filter; a cursor read under it expires when the filter is edited.
What each row is: a query, a page, a country, a device, a query on a page, or a segment (a saved group; needs segment_dimension).
With dimension segment: whether the segments group pages or queries.
all (default); growing or decaying against the comparison, ranked by the size of the change; new: first observed inside the range (query and page only).
Rows per page (1 to 500; default 25). Pages past the first 10 rows are a paid feature (table_all_rows).
The previous page's next_cursor: the next page at the same snapshot. Never construct one. One older than 24 hours, of another property, or read before the filter or brand was edited is SEARCH_VIEW_EXPIRED: read page 1 again.
Response
One page of a site's Search Console rows
Changes
No recorded changes to this operation across all 1 revision of this API.