What does Google say about SEO? /
Quick SEO Quiz

Test your SEO knowledge in 3 questions

Less than 30 seconds. Find out how much you really know about Google search.

🕒 ~30s 🎯 3 questions 📚 SEO Google

Official statement

Search Console API data and user interface data come from exactly the same database tables. The API allows you to obtain more example rows. Totals can differ because certain low-impression queries are filtered from the line data.
🎥 Source video

Extracted from a Google Search Central video

💬 EN 📅 30/01/2022 ✂ 17 statements
Watch on YouTube →
Other statements from this video 16
  1. Google attribue-t-il vraiment le même poids à tous vos backlinks ?
  2. L'emplacement des liens internes a-t-il vraiment un impact sur le SEO ?
  3. Google classe-t-il vraiment les sites dans des catégories fixes ?
  4. La cohérence NAP impacte-t-elle vraiment le référencement local ou seulement le Knowledge Graph ?
  5. Comment éviter que Google se trompe à cause d'informations conflictuelles entre votre site et votre profil d'établissement ?
  6. Les liens réciproques sont-ils vraiment sans risque pour votre SEO ?
  7. La fréquence des mots-clés influence-t-elle vraiment le classement Google ?
  8. Faut-il vraiment nettoyer TOUTES les pages hackées ou peut-on laisser Google faire le tri ?
  9. Pourquoi Google refuse-t-il d'indexer une partie de votre site même s'il est techniquement parfait ?
  10. Les emojis dans les balises title et meta description apportent-ils un avantage SEO ?
  11. Pourquoi vos FAQ n'apparaissent-elles pas en rich results malgré un balisage correct ?
  12. Faut-il vraiment réutiliser la même URL pour les pages saisonnières chaque année ?
  13. Les Core Web Vitals n'affectent-ils vraiment ni le crawl ni l'indexation ?
  14. Pourquoi Google réinitialise-t-il l'évaluation d'un site lors d'une migration de sous-domaine vers domaine principal ?
  15. Le TLD .edu booste-t-il vraiment votre référencement ?
  16. Les géo-redirects peuvent-ils réellement bloquer l'indexation de votre contenu ?
📅
Official statement from (4 years ago)
TL;DR

Search Console API and user interface pull from identical database tables. The main difference: the API lets you extract more example rows, but totals can vary because certain low-impression queries are filtered from detailed line data. This clarification explains why your API exports don't always perfectly match what you see in the UI.

What you need to understand

Why is Google making this clarification?

Many SEO practitioners have noticed numerical discrepancies between data exported via the Search Console API and data displayed in the web interface. Google is addressing this confusion head-on.

The database is unified. Both channels query the same tables. There's no double counting, no alternative data source. The divergence comes from the processing applied when displaying detailed line items.

What's the concrete difference between API and UI?

The API offers a larger volume of exportable rows. You can retrieve up to 50,000 rows per API request versus only 1,000 rows in the web interface by default.

But beware: some queries generate very few impressions. Google filters these low-volume rows from detailed exports to avoid cluttering reports with statistical noise. This filtering doesn't affect aggregated totals, but can create row-by-row discrepancies.

How should you interpret totals that differ?

The totals displayed at the top of the interface (total clicks, total impressions) include all data, including rows filtered from detailed breakdowns. This is why the sum of exported rows can be lower than the global total.

This filtering mechanism is documented: Google considers that queries with fewer than a handful of impressions don't deserve to appear in detailed exports to preserve signal quality.

  • API and UI data come from exactly the same database tables
  • The API allows you to obtain up to 50,000 rows versus 1,000 in the web interface
  • Certain queries with very low impressions are filtered from detailed line data
  • Aggregated totals include all data, even rows filtered from the detailed breakdown
  • This difference explains why sum(rows) ≠ global total in some cases

SEO Expert opinion

Does this statement really clarify the issue?

Yes and no. It confirms what many suspected: the source is singular. No more debate about potential double counting or contradictory data between channels.

But it remains vague on the exact filtering threshold. At what impression count is a row retained? Google doesn't specify. [To verify] based on field observations, this threshold appears to vary and could depend on the site's total data volume.

What are the implications for your long-tail analysis?

Filtering low-impression queries poses a real problem for anyone wanting to analyze the long tail in depth. These ultra-niche queries, often with 1-3 impressions, disappear from exports.

Concretely: if you're trying to identify all queries generating traffic, even marginal traffic, you're working with partially truncated data. The API provides more rows, sure, but the floor remains opaque.

Is this logic consistent with observed practices?

Perfectly. Discrepancies between row sum and global total have been documented for years. Google is finally justifying this behavior through a data quality choice rather than raw exhaustiveness.

Be cautious, however: some third-party tools built on the API may display totals different from the interface, creating confusion among clients. Let's be honest, you need to explain this nuance in every report presentation.

If you're using the API for client reporting, systematically document this methodological difference. The risk: the client compares your numbers with their GSC interface and questions the reliability of your analyses.

Practical impact and recommendations

What should you concretely do with this information?

Prioritize the API for bulk exports if you need depth (50,000 rows vs 1,000). But stay aware that even the API filters ultra-marginal queries.

In your performance analyses, always base yourself on aggregated totals rather than the sum of exported rows. It's the global total that reflects exhaustive reality.

How do you avoid interpretation errors?

Never directly compare the sum of API rows with a UI total without checking whether data has been filtered. This classic mistake distorts variance analyses over time.

If you're building automated dashboards, integrate an alert when the gap between sum(rows) and total exceeds a certain threshold. This signals an unusual volume of filtered queries, often a symptom of highly dispersed long-tail traffic.

What tools or processes should you implement?

Automate your API exports with a script that retrieves global totals in parallel with detailed rows. Store both in your database to maintain historical consistency.

Document this methodological difference in your client reports. A simple footnote explaining Google's filtering is enough to prevent misunderstandings and strengthens your technical credibility.

  • Use the Search Console API to retrieve up to 50,000 rows per export
  • Base your KPIs on aggregated totals, not the sum of detailed rows
  • Store global totals and detailed rows in parallel in your analysis tools
  • Document Google's filtering in your reports to anticipate client questions
  • Set up alerts if the sum/total gap exceeds an unusual threshold
  • Explain this technical nuance during SEO performance presentations
Optimal exploitation of Search Console data requires a fine understanding of filtering mechanisms and technical infrastructure capable of cross-referencing API and UI without information loss. These methodological subtleties, combined with data volume, make exhaustive in-house analysis complex. For organizations with advanced SEO reporting needs, partnering with a specialized agency enables deployment of appropriate technical processes while guaranteeing consistency of metrics presented to decision-makers.

❓ Frequently Asked Questions

L'API Search Console est-elle plus fiable que l'interface web ?
Non, les deux puisent dans les mêmes tables de base de données. L'API offre simplement plus de lignes exportables (50 000 vs 1 000) mais applique les mêmes filtres sur les requêtes à faibles impressions.
Pourquoi la somme de mes lignes exportées ne correspond pas au total affiché ?
Google filtre certaines requêtes à très faibles impressions des lignes détaillées. Le total global inclut ces données filtrées, d'où l'écart. C'est un comportement documenté et normal.
Peut-on récupérer toutes les requêtes sans filtrage ?
Non, Google applique systématiquement un filtrage sur les requêtes générant très peu d'impressions. Le seuil exact n'est pas communiqué publiquement et semble varier selon les sites.
Quel canal utiliser pour mes analyses SEO : API ou interface ?
Privilégiez l'API si vous avez besoin de volumétrie (analyses massives, historisation). Pour du monitoring quotidien simple, l'interface suffit. Dans tous les cas, basez vos KPIs sur les totaux agrégés.
Les outils tiers qui utilisent l'API sont-ils fiables ?
Oui, si l'outil récupère correctement les totaux globaux en plus des lignes détaillées. Vérifiez que les chiffres présentés correspondent aux totaux GSC, pas à la somme des lignes filtrées.
🏷 Related Topics
AI & SEO JavaScript & Technical SEO Pagination & Structure Search Console

🎥 From the same video 16

Other SEO insights extracted from this same Google Search Central video · published on 30/01/2022

🎥 Watch the full video on YouTube →

Related statements

💬 Comments (0)

Be the first to comment.

2000 characters remaining
🔔

Get real-time analysis of the latest Google SEO declarations

Be the first to know every time a new official Google statement drops — with full expert analysis.

No spam. Unsubscribe in one click.