Google Search Console API का उपयोग कैसे करूँ?

Q: Google Search Console API का उपयोग कैसे करूँ?

Cloud प्रोजेक्ट बनाएँ, API सक्षम करें, OAuth से अधिकृत करें, फिर परफ़ॉर्मेंस डेटा, URL Inspection और साइटमैप क्वेरी करें। यहाँ चरण और कोटा दिए गए हैं।

Google Cloud console में एक प्रोजेक्ट बनाएँ, Google Search Console API सक्षम करें, OAuth 2.0 क्रेडेंशियल बनाएँ, और ऐसे Google खाते से साइन इन करें जिसके पास प्रॉपर्टी का एक्सेस हो। इसके बाद आप चार रिसोर्स पर अनुरोध भेज सकते हैं: क्लिक, इम्प्रेशन, CTR और पोज़िशन के लिए Search Analytics; इंडेक्स स्थिति के लिए URL Inspection; Sitemaps; और Sites। केवल API key से काम नहीं चलता: हर कॉल के लिए OAuth टोकन ज़रूरी है, और कोटा तय करता है कि आप कितना डेटा माँग सकते हैं।

API क्या कवर करती है, और क्या नहीं

रिसोर्स	मेथड	किस काम के लिए
Search Analytics	`query`	क्वेरी, पेज, देश, डिवाइस, सर्च अपीयरेंस, तारीख या घंटे के अनुसार परफ़ॉर्मेंस पंक्तियाँ
URL Inspection	`index.inspect`	किसी एक URL का इंडेक्स किया गया संस्करण: कवरेज, पिछला क्रॉल, कैनोनिकल
Sitemaps	`list`, `get`, `submit`, `delete`	किसी प्रॉपर्टी के सबमिट किए गए साइटमैप प्रबंधित करना
Sites	`list`, `get`, `add`, `delete`	साइन-इन किए गए खाते की प्रॉपर्टी

API बस इतनी ही है। लिंक, Crawl stats, Page indexing रिपोर्ट और Core Web Vitals रिपोर्ट के लिए कोई endpoint नहीं है, इसलिए ये Search Console इंटरफ़ेस में ही रहती हैं। URL Inspection वही बताता है जो Google के इंडेक्स में है; यह पेज का लाइव टेस्ट नहीं है।

एक्सेस सेट करें

Google Cloud console में प्रोजेक्ट बनाएँ या चुनें।
उस प्रोजेक्ट के लिए Google Search Console API सक्षम करें।
OAuth consent screen कॉन्फ़िगर करें और OAuth client ID बनाएँ।
एक स्कोप का अनुरोध करें: पढ़ने के लिए https://www.googleapis.com/auth/webmasters.readonly, या साइटमैप सबमिट/डिलीट करने के लिए भी https://www.googleapis.com/auth/webmasters।
ऐसे खाते से साइन इन करें जिसके पास प्रॉपर्टी पर अनुमति हो। परफ़ॉर्मेंस डेटा पढ़ने के लिए कम से कम रीड एक्सेस चाहिए; 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-एन्कोड करके दी जाती है: Domain प्रॉपर्टी के लिए sc-domain:example.com, या URL-prefix प्रॉपर्टी के लिए सटीक प्रीफ़िक्स, अंत के स्लैश सहित, जैसे https://www.example.com/। सबसे महत्वपूर्ण फ़ील्ड:

तारीखें समावेशी होती हैं और 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 प्रति दिन।
URL Inspection कोटा। प्रत्येक प्रॉपर्टी के लिए 2,000 इंस्पेक्शन प्रति दिन और 600 प्रति मिनट।
16 महीने का इतिहास, और डेटा आमतौर पर दिन समाप्त होने के दो से तीन दिन बाद उपलब्ध होता है।
पंक्तियों का योग कुल के बराबर नहीं होता। दुर्लभ क्वेरी, क्वेरी-स्तर की पंक्तियों से बाहर रह जाती हैं, और पेज के आधार पर ग्रुप करने पर इम्प्रेशन प्रॉपर्टी के आधार पर ग्रुप करने से अलग गिने जाते हैं, इसलिए कुल आँकड़े ऐसे अनुरोध से पढ़ें जिसमें query डाइमेंशन न हो।

आम गलतियाँ

प्रॉपर्टी https:// होने पर http:// का उपयोग करने, या अंत का स्लैश छोड़ देने पर अनुमति की त्रुटि आती है, भले ही खाते के पास एक्सेस हो।
URL Inspection में प्रॉपर्टी के बाहर का URL माँगने पर अनुरोध अस्वीकार हो जाता है: URL आपके द्वारा दिए गए siteUrl के अंतर्गत होना चाहिए।
एक ही कॉल में query और page के आधार पर ग्रुप किया गया पूरा महीना केवल शीर्ष पंक्तियाँ लौटाता है। दैनिक अनुरोध ज़्यादा पंक्तियाँ लौटाते हैं।

AutoPSEO कैसे मदद करता है

अगर आप OAuth और पेजिनेशन खुद नहीं सँभालना चाहते, तो AutoPSEO Google साइन-इन से कनेक्ट होता है और वही डेटा /v1 पर अपनी REST API (OpenAPI 3.1 दस्तावेज़ के साथ) और एक MCP सर्वर के ज़रिए उपलब्ध कराता है, जिसे Account → API keys से मिली API key से अधिकृत किया जाता है। रीड-ओनली keys उपलब्ध हैं, search analytics endpoint प्रति कॉल अधिकतम 5,000 पंक्तियाँ लौटाता है, और ऐप के URL Inspection टूल Google के 2,000-प्रति-दिन के कोटे का हिसाब आपके लिए रखते हैं। देखें MCP और API keys। बिना पाइपलाइन लिखे 16 महीने से पुराना डेटा सहेजने के लिए, Search Console डेटा कितने समय तक रखता है देखें।

स्रोत: Google की API reference, Search Analytics query method, usage limits, getting all your data और authorisation guide।