Official statement
Other statements from this video 23 ▾
- 1:09 Hreflang in HTML or XML Sitemap: Is There Really a Difference for Google?
- 3:52 Is it true that you have to wait for the next core update to recover your traffic?
- 5:29 Why do your rich snippets only show up in site query and not in regular SERPs?
- 6:02 Should you really rely on external testers instead of SEO tools to evaluate quality?
- 9:42 How can you balance internal navigation to maximize both crawling and ranking?
- 11:26 Is the URL Parameters Tool in Search Console really doomed?
- 13:19 Is the URL Parameters Tool in Search Console really unnecessary for your e-commerce site?
- 17:17 Do you really need to follow technical guidelines to achieve a featured snippet?
- 19:47 Why does Google refuse to track featured snippets in Search Console?
- 20:43 Is server authentication the only real shield against indexing staging environments?
- 23:23 Can your staging URLs be indexed even without any links pointing to them?
- 26:01 Are structured data really unnecessary for Google SEO?
- 27:03 Should you really stop adding the current year to your SEO titles?
- 28:39 Can Google really detect timestamp manipulation on news sites?
- 30:14 Homepage with URL Parameters: Should You Really Index Multiple Versions or Canonicalize Everything?
- 31:43 What happens when you migrate from www to non-www without 301 redirects, and how does it destroy your SEO?
- 33:03 Should you reconfigure Search Console every time you migrate from www to non-www?
- 35:09 Should you really worry when a 404 page turns back to 200?
- 36:34 404 or noindex for deindexing: which method should you really prefer?
- 38:15 Do uppercase URLs really create duplicate content that Google penalizes?
- 40:20 Is keyword cannibalization really an SEO issue or just a myth?
- 43:01 Why does Google ignore your date structured data if it's not visible?
- 53:34 Is the URL switch between AMP and canonical HTML capable of really harming your ranking?
The Search Console API and the web interface share the same backend — there is no technical difference between the two systems. If you notice data discrepancies, check domain verification: HTTP vs HTTPS, www vs non-www. The solution almost always lies in a misconfiguration of the property, not an API bug.
What you need to understand
Do the API and the interface really use the same backend?
Yes. John Mueller confirms it unequivocally: the Search Console API and the web interface query exactly the same data source. No differentiated processing, no specific latency, no filters applied on the API side.
This clarification puts an end to a persistent belief among some practitioners: the idea that the API would provide 'raw' data while the interface applied filters or aggregations. That is false. Both access points point to the same backend system, with the same sampling rules and limitations.
Where do the observed data discrepancies come from?
The problem almost always arises at the level of domain verification. Search Console strictly distinguishes between HTTP and HTTPS, www and non-www — each combination constitutes a distinct property.
Imagine: you verify your property in HTTP without www in the interface, but your API script queries the HTTPS version with www. Result: zero data returned by the API, while the interface displays metrics. This is not a bug — you are simply querying two different properties.
What is the difference between a domain property and a URL property?
Search Console offers two types of properties: domain property (covers all HTTP/HTTPS variations, www/non-www, subdomains) and URL prefix property (a single specific version). The domain property requires DNS verification.
If you use a URL prefix property, you must query the API with exactly the same prefix as the one verified. A single character difference — a final slash, a missing s — and the API will return nothing. With a domain property, this issue disappears, but the initial verification is more stringent.
- The API and the web interface share the same backend — no technical difference between the two systems.
- Data discrepancies arise from differences in domain verification: HTTP vs HTTPS, www vs non-www.
- A domain property aggregates all variations; a URL prefix property only covers one specific version.
- Always ensure your API script queries exactly the same property as the one displayed in the interface.
- A single character difference in the URL can cause the API call to fail without an explicit error message.
SEO Expert opinion
Is this statement consistent with practices observed in the field?
Totally. Practitioners who have delved into this issue confirm: API/interface discrepancies almost always stem from a configuration error, not a technical divergence. I have personally debugged dozens of scripts querying the wrong property — and in 100% of cases, correcting the property URL resolved the issue.
What remains unclear is the propagation delay between verifying a new property and its availability via the API. Some practitioners report latencies of several hours, while others report no delay. Google does not document this point — [To be verified] if you are deploying critical automations.
What nuances should be added to this statement?
Mueller's statement is correct, but it overlooks sampling limitations. Search Console does not display all your queries — only a representative sample. This limitation applies to both the interface and the API, but becomes more apparent when aggregating data via a script.
Another point: IAM permissions and API quotas can create perceived discrepancies. If your service account does not have the appropriate permissions on the property, the API will return a 403 error — which some scripts interpret as 'no data'. This is not a backend issue, it’s an authentication problem.
In what cases does this rule not apply?
If you observe data in the interface but zero results via API after verifying the property, two possible scenarios: either you are querying a date range prior to the property verification, or you have hit sampling limits for very granular dimensions.
Also beware of disabled or deleted properties. The interface may cache data for a few days after the deletion of a property, while the API will return an error immediately. This is not documented but is empirically observed — [To be verified] in your own audits.
Practical impact and recommendations
What should you concretely do to avoid API/interface discrepancies?
First, list all your verified properties in Search Console. Note their exact prefix: HTTP or HTTPS, www or non-www, final slash or not. Then, ensure that your API script queries exactly the same string of characters.
If you use multiple domain variations (HTTP redirects to HTTPS, non-www redirects to www), prefer a domain property. It requires DNS verification, but eliminates 90% of configuration errors on the API side. This is an initial investment that will save you hours of debugging.
What mistakes should you avoid when querying the API?
Never assume that your site's canonical URL matches the verified property in Search Console. These are two distinct concepts. Your site may canonically point to HTTPS with www, but if you have only verified HTTP without www, the API will return nothing.
Another pitfall: service account permissions. If you use OAuth to authenticate your API calls, ensure that the account has 'Owner' or 'Full access user' rights on the property. 'Restricted access user' is not sufficient for some endpoints.
How to verify that my script queries the right property?
Use the searchanalytics.query endpoint with a short date range (last 7 days) and no dimensions — just the totals. If this call returns zero rows while the interface shows data for the same period, you are querying the wrong property.
To diagnose precisely, list all your properties using the sites.list endpoint. Compare the returned URLs with those displayed in the interface. They must match character for character, final slash included. If any discrepancy appears, that’s where your bug lies.
- Check that the property URL used in the API matches exactly that of the interface (HTTP/HTTPS, www, final slash)
- Prefer a domain property (DNS verification) to cover all URL variations
- Test the API call with a short date range and no dimensions to isolate configuration errors
- Use
sites.listto compare available properties via API with those in the interface - Check service account permissions: 'Owner' or 'Full access user' rights required
- Document API quotas (1,200 requests/minute) and implement rate limiting in your scripts
❓ Frequently Asked Questions
Pourquoi l'API Search Console ne retourne-t-elle aucune donnée alors que l'interface en affiche ?
Dois-je utiliser une propriété de domaine ou une propriété d'URL préfixe ?
Quels sont les quotas de l'API Search Console ?
Les données de l'API sont-elles échantillonnées comme celles de l'interface ?
Quelles permissions sont nécessaires pour interroger l'API Search Console ?
🎥 From the same video 23
Other SEO insights extracted from this same Google Search Central video · duration 57 min · published on 04/09/2020
🎥 Watch the full video on YouTube →
💬 Comments (0)
Be the first to comment.