Πώς χρησιμοποιώ το Google Search Console API;

Q: Πώς χρησιμοποιώ το Google Search Console API;

Δημιουργήστε ένα project στο Cloud, ενεργοποιήστε το API, κάντε εξουσιοδότηση με OAuth και στη συνέχεια αντλήστε δεδομένα επιδόσεων, έλεγχο URL και sitemaps. Δείτε τα βήματα και τα όρια χρήσης.

Δημιουργήστε ένα project στο Google Cloud console, ενεργοποιήστε το Google Search Console API, δημιουργήστε διαπιστευτήρια OAuth 2.0 και συνδεθείτε με έναν λογαριασμό Google που έχει πρόσβαση στην ιδιοκτησία. Στη συνέχεια μπορείτε να στέλνετε αιτήματα σε τέσσερις πόρους: Search Analytics για κλικ, εμφανίσεις, CTR και θέση· URL Inspection για την κατάσταση ευρετηρίασης· Sitemaps· και Sites. Τα κλειδιά API από μόνα τους δεν αρκούν: κάθε κλήση απαιτεί διακριτικό OAuth, ενώ τα όρια χρήσης περιορίζουν πόσα δεδομένα μπορείτε να ζητήσετε.

Τι καλύπτει το API και τι όχι

Πόρος	Μέθοδοι	Χρήση
Search Analytics	`query`	Γραμμές επιδόσεων ανά ερώτημα, σελίδα, χώρα, συσκευή, μορφή εμφάνισης στα αποτελέσματα, ημερομηνία ή ώρα
URL Inspection	`index.inspect`	Η ευρετηριασμένη έκδοση ενός URL: κάλυψη, τελευταία σάρωση, canonicals
Sitemaps	`list`, `get`, `submit`, `delete`	Διαχείριση των sitemaps που έχει υποβάλει μια ιδιοκτησία
Sites	`list`, `get`, `add`, `delete`	Οι ιδιοκτησίες του λογαριασμού με τον οποίο έχετε συνδεθεί

Αυτό είναι όλο το API. Οι συνδέσεις (links), τα στατιστικά σάρωσης (Crawl stats), η αναφορά ευρετηρίασης σελίδων (Page indexing) και η αναφορά Core Web Vitals δεν διαθέτουν endpoint, οπότε παραμένουν μέσα στη διεπαφή του Search Console. Το URL Inspection δείχνει τι υπάρχει στο ευρετήριο της Google, και δεν αποτελεί ζωντανό έλεγχο της σελίδας.

Ρύθμιση πρόσβασης

Στο Google Cloud console, δημιουργήστε ή επιλέξτε ένα project.
Ενεργοποιήστε το Google Search Console API για αυτό το project.
Ρυθμίστε την οθόνη συγκατάθεσης OAuth και δημιουργήστε ένα αναγνωριστικό πελάτη OAuth (OAuth client ID).
Ζητήστε ένα scope: https://www.googleapis.com/auth/webmasters.readonly για ανάγνωση ή https://www.googleapis.com/auth/webmasters για να μπορείτε επιπλέον να υποβάλλετε ή να διαγράφετε sitemaps.
Συνδεθείτε με λογαριασμό που έχει δικαιώματα στην ιδιοκτησία. Για την ανάγνωση δεδομένων επιδόσεων απαιτείται τουλάχιστον πρόσβαση ανάγνωσης· το API βλέπει ακριβώς ό,τι βλέπει και ο συγκεκριμένος λογαριασμός.

Το πρώτο σας ερώτημα στο Search Analytics

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Ο ιστότοπος μπαίνει στη διαδρομή, κωδικοποιημένος ως URL: sc-domain:example.com για ιδιοκτησία τομέα (Domain) ή το ακριβές πρόθεμα με την τελική κάθετο, όπως https://www.example.com/, για ιδιοκτησία προθέματος URL. Τα πιο σημαντικά πεδία:

Οι ημερομηνίες είναι συμπεριληπτικές και στην ώρα Ειρηνικού (Pacific Time).
Το type είναι από προεπιλογή web· τα υπόλοιπα είναι image, video, news, googleNews και discover. Το καθένα χρειάζεται δικό του αίτημα.
Τα φίλτρα μπαίνουν στο dimensionFilterGroups, με τελεστές από equals και contains έως includingRegex και excludingRegex (σύνταξη RE2).
Το rowLimit κυμαίνεται από 1 έως 25.000 (προεπιλογή 1.000)· το startRow σας επιτρέπει να σελιδοποιήσετε τα υπόλοιπα.
Το dataState είναι από προεπιλογή final· το all προσθέτει πρόσφατες, ημιτελείς ημέρες και το hourly_all λειτουργεί με τη διάσταση hour.

Κάθε γραμμή επιστρέφει keys, clicks, impressions, ctr (0 έως 1) και position, ταξινομημένα κατά κλικ, εκτός αν ομαδοποιήσετε ανά ημερομηνία.

Τα όρια που διαμορφώνουν τον κώδικά σας

50.000 γραμμές ανά ημέρα και ανά τύπο αναζήτησης. Σελιδοποιήστε με το startRow ανά 25.000 και σταματήστε όταν λάβετε κενή απάντηση. Για να πάρετε τα περισσότερα δεδομένα, υποβάλλετε ερώτημα για μία ημέρα τη φορά.
Όριο φόρτου. Η ομαδοποίηση ή το φιλτράρισμα ταυτόχρονα ανά σελίδα και ερώτημα είναι το πιο δαπανηρό αίτημα, ενώ τα μεγάλα χρονικά διαστήματα κοστίζουν περισσότερο από τα μικρά. Αν υπερβείτε το βραχυπρόθεσμο όριο, η Google σας ζητά να περιμένετε 15 λεπτά.
Ρυθμοί αιτημάτων. 1.200 ερωτήματα ανά λεπτό ανά ιστότοπο και ανά χρήστη· 40.000 ανά λεπτό και 30.000.000 ανά ημέρα ανά project.
Όριο URL Inspection. 2.000 ελέγχοι ανά ημέρα και 600 ανά λεπτό για κάθε ιδιοκτησία.
Ιστορικό 16 μηνών, ενώ τα δεδομένα είναι συνήθως διαθέσιμα δύο έως τρεις ημέρες μετά το τέλος της ημέρας.
Οι γραμμές δεν αθροίζουν στα σύνολα. Τα σπάνια ερωτήματα παραλείπονται από τις γραμμές επιπέδου ερωτήματος και η ομαδοποίηση ανά σελίδα μετρά τις εμφανίσεις διαφορετικά από την ομαδοποίηση ανά ιδιοκτησία, γι' αυτό διαβάστε τα σύνολα από αίτημα χωρίς τη διάσταση query.

Συνηθισμένα λάθη

Η χρήση του http:// όταν η ιδιοκτησία είναι https://, ή η παράλειψη της τελικής καθέτου, προκαλεί σφάλμα δικαιωμάτων ακόμη και όταν ο λογαριασμός έχει πρόσβαση.
Η αίτηση ελέγχου ενός URL εκτός της ιδιοκτησίας στο URL Inspection απορρίπτεται: το URL πρέπει να βρίσκεται κάτω από το siteUrl που περνάτε.
Ένας ολόκληρος μήνας ομαδοποιημένος ανά ερώτημα και σελίδα σε μία κλήση επιστρέφει μόνο τις κορυφαίες γραμμές. Τα ημερήσια αιτήματα επιστρέφουν περισσότερες.

Πώς βοηθά το AutoPSEO

Αν προτιμάτε να μη συντηρείτε OAuth και σελιδοποίηση, το AutoPSEO συνδέεται μέσω σύνδεσης με Google και εκθέτει τα ίδια δεδομένα μέσω του δικού του REST API στο /v1 (με έγγραφο OpenAPI 3.1) και ενός διακομιστή MCP, με εξουσιοδότηση μέσω κλειδιού API από το Account → API keys. Διατίθενται κλειδιά μόνο ανάγνωσης, το endpoint του search analytics επιστρέφει έως 5.000 γραμμές ανά κλήση και τα εργαλεία URL Inspection της εφαρμογής παρακολουθούν για λογαριασμό σας το όριο των 2.000 ελέγχων ημερησίως της Google. Δείτε MCP και κλειδιά API. Για να διατηρήσετε δεδομένα πέρα από τους 16 μήνες χωρίς να γράψετε δική σας διαδικασία (pipeline), δείτε πόσο καιρό διατηρεί δεδομένα το Search Console.

Πηγές: της Google API reference, μέθοδος Search Analytics query, όρια χρήσης, λήψη όλων των δεδομένων σας και οδηγός εξουσιοδότησης.