GSC knowledge base
GSC development and data tutorials and troubleshooting guide
Permissions, APIs, pagination, quotas, and data warehouses: readable data does not equal the full backend. Choose a tutorial based on the specific problem, and verify operations, limitations, and validation results item by item.
Choose the data route before building an integration
What to prepare
Define the property, dimensions, date window and expected use. Search Analytics, URL Inspection and BigQuery exports answer different questions.
| Your situation | First action | Read next |
|---|---|---|
| Build a search performance report | Choose dimensions and filters, page through results and retain the request alongside the response. | Search Analytics queries: dimensions, filters, and pagination |
| Requests hit a limit | Separate per-site and project limits, use bounded retries and preserve errors rather than returning zero. | API quotas: caching and backoff, not unlimited retries |
| You need a durable data warehouse | Verify export eligibility, permissions, table dates and completeness before treating a query as a full history. | Bulk export to BigQuery: determine data and cost responsibility first |
| Totals and rows disagree | Check aggregation, privacy filtering and data coverage instead of inventing missing rows. | Queries fewer than the total: missing, zero, and errors are separate |
When to stop and verify
The dataset carries its scope, dates and limitations; failures remain distinct from zero. Do not use an unsupported API to submit ordinary articles for indexing.
Choose another Search Console problem · Check the official requirements
Development and data
Permissions, APIs, pagination, quotas, and data warehouse: readable data does not equal the full backend.
Search Console API: what it can read, what it cannot do for you
Choose an API method for a defined operation and verify its authorization and property scope. Search Analytics reads performance, URL Inspection reads indexed information, and other resources have their own methods. The API is not a replica of every GSC report or a general ordinary-article indexing submission service.
Steps · error branches · checklistSearch Analytics queries: dimensions, filters, and pagination
Define what one result row means, then keep the property, dates, type, filters and aggregation stable across pagination. More pages do not guarantee complete data. A page-query mapping requires joint dimensions; separate top-page and top-query lists cannot be joined by row order.
Steps · error branches · checklistAPI quotas: caching and backoff, not unlimited retries
A quota failure needs a record of the endpoint, property, user, project, request rate and error response. Search Analytics load limits and URL Inspection request quotas are different. Repeatedly retrying every failed job can deepen the failure; first reduce the workload that caused it.
Steps · error branches · checklistBulk export to BigQuery: determine data and cost responsibility first
Use bulk export when you need a durable, queryable Search Console dataset, and budget for Cloud storage and queries. Setup is not a successful export. Verify the first saved date and both performance tables, then aggregate repeated rows correctly. The setup does not backfill your earlier history.
Steps · error branches · checklistQueries fewer than the total: missing, zero, and errors are separate
A number is useful only with its scope: property, dates, search type, filters, aggregation and collection method. A missing query, failed request or unavailable report is not zero. Establish those boundaries before comparing dashboards or asking AI to explain a change.
Steps · error branches · checklistCheck guide coverage and product capabilities separately
SEO operations adds bounded technical checks, saved index-version reads, laboratory records and human content review. Native Google security, Discover, News and enhancement reports still require their own tools. A guide explains a method; it does not establish every report is connected.
View real product capabilities