Official statement
Other statements from this video 23 ▾
- 1:09 Hreflang en HTML ou sitemap XML : y a-t-il vraiment une différence pour Google ?
- 3:52 Faut-il vraiment attendre la prochaine core update pour récupérer son trafic ?
- 5:29 Pourquoi vos rich snippets n'apparaissent-ils qu'en site query et pas dans les SERP classiques ?
- 6:02 Faut-il vraiment se fier aux testeurs externes plutôt qu'aux outils SEO pour évaluer la qualité ?
- 9:42 Comment équilibrer la navigation interne pour maximiser crawl et ranking ?
- 11:26 L'outil de paramètres d'URL de la Search Console est-il vraiment condamné ?
- 13:19 L'outil de paramètres d'URL de la Search Console est-il vraiment inutile pour votre e-commerce ?
- 17:17 Faut-il vraiment respecter des directives techniques pour décrocher un featured snippet ?
- 19:47 Pourquoi Google refuse-t-il de tracker les featured snippets dans Search Console ?
- 20:43 Pourquoi l'authentification serveur reste-t-elle la seule vraie protection contre l'indexation des environnements de staging ?
- 23:23 Vos URLs de staging peuvent-elles être indexées même sans aucun lien pointant vers elles ?
- 26:01 Les données structurées sont-elles vraiment inutiles pour le référencement Google ?
- 27:03 Faut-il vraiment arrêter d'ajouter l'année en cours dans vos titres SEO ?
- 28:39 Google peut-il vraiment détecter la manipulation de timestamps sur les sites d'actualité ?
- 30:14 Homepage avec paramètres URL : faut-il vraiment indexer plusieurs versions ou tout canonicaliser ?
- 31:43 Pourquoi une migration www vers non-www sans redirections 301 détruit-elle votre SEO ?
- 33:03 Faut-il reconfigurer Search Console à chaque migration de préfixe www/non-www ?
- 35:09 Faut-il vraiment s'inquiéter quand une page 404 repasse en 200 ?
- 36:34 404 ou noindex pour désindexer : quelle méthode privilégier vraiment ?
- 38:15 Les URLs en majuscules génèrent-elles du duplicate content que Google pénalise ?
- 40:20 La cannibalisation de mots-clés est-elle vraiment un problème SEO ou juste un mythe ?
- 43:01 Pourquoi Google ignore-t-il vos structured data de date si elles ne sont pas visibles ?
- 53:34 AMP et HTML canonique : le switch d'URL peut-il vraiment tuer votre 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.