Loading Light/Dark Toggle
वापस ब्लॉग पर

Google Search API JSON प्रतिक्रिया: organic_results समझाया गया

Alex Johnson
Alex Johnson

Senior Web Scraping Engineer

12-Nov-2026

TL;DR:

  • organic_results ऑर्गेनिक सर्च रिकॉर्ड्स का एक संग्रह है। हर रिकॉर्ड के returned position, title, snippet, और link को पढ़ें, बाकी सर्च मॉड्यूल्स के साथ मिलाए बिना।
  • Returned position और array order अलग-अलग मान हैं। डेटासेट तैयार करते समय दोनों को सुरक्षित रखें।
  • Returned link अपने आप में सत्यापित अंतिम URL नहीं होता। मध्यवर्ती और destination-candidate अवस्थाओं को अलग-अलग रखें।
  • Missing फील्ड्स दिखते रहने चाहिए। अनुपस्थित snippet, खाली स्ट्रिंग, और खराब रिकॉर्ड को अलग-अलग तरीके से संभालना चाहिए।

परिचय: फ्लैटन करने से पहले Response को पढ़ें

Google Search API का JSON response, organic results के साथ-साथ knowledge panels, local sections, related questions, और अन्य query-निर्भर मॉड्यूल्स भी रख सकता है। हर उस ऑब्जेक्ट को फ्लैटन कर देना जिसमें title फील्ड हो, ऐसे डेटासेट की ओर ले जाता है जिसमें अर्थ आपस में मिले हुए हों।

यह ट्यूटोरियल Scrapeless Google Search API में organic_results पर केंद्रित है। लक्ष्य है शीर्षक, स्निपेट, position, और links के लिए एक छोटा, जाँचने योग्य रिकॉर्ड फॉर्मेट बनाना। यह न तो कोई rank tracker बनाता है और न ही यह दावा करता है कि हर returned link को पहले ही final target URL के साथ मिलान करके जाँच लिया गया है।

Google Search response example और actor request workflow आस‑पास का request संदर्भ प्रदान करते हैं। यहाँ उपयोगी काम उस समय शुरू होता है जब एक पूरा हो चुका response सहेज लिया गया हो।

organic_results में क्या होता है

organic_results फील्ड organic result ऑब्जेक्ट्स की एक array है, जिनके फील्ड्स की उपलब्धता हर आइटम पर अलग‑अलग जाँची जानी चाहिए। कोई रिकॉर्ड destination पेज की पूरी कॉपी नहीं होता।

Field डेटासेट में अर्थ हैंडल करने का नियम
position API द्वारा लौटाई गई position इसे दोबारा गणना किए बिना सुरक्षित रखें
title परिणाम का शीर्षक null या missing मानों को टेक्स्ट से अलग पहचानने योग्य रखें
snippet सर्च‑परिणाम का अंश इसे पूरे पेज कंटेंट नहीं, बल्कि सर्च ऑब्ज़र्वेशन की तरह मानें
link लौटाया गया परिणाम URL downstream destination matching से पहले इसका वर्गीकरण करें
redirect_link मौजूद होने पर अतिरिक्त redirect‑form लिंक अलग से सहेजें; link को अपने आप replace न करें
source उपलब्ध होने पर दिखाया गया source label यह मान कर न चलें कि यह कोई registrable डोमेन है

यह तालिका निरीक्षण करने के लिए फील्ड्स का वर्णन करती है, न कि यह गारंटी कि हर आइटम में हर key होगी। Parameter reference request नियंत्रण परिभाषित करता है; इसे विभिन्न queries में समान परिणाम मॉड्यूल्स के वादे के रूप में नहीं पढ़ा जाना चाहिए।

JSON, JSON स्पेसिफिकेशन में वर्णित अनुसार, null, strings, और arrays जैसे मानों की अनुमति देता है। एक लचीले response फॉर्मेट को भी सोच‑समझकर बनाए गए consumer कॉन्ट्रैक्ट की जरूरत होती है। तय करें कि कौन‑से missing मान आपकी एप्लिकेशन सुरक्षित रख सकती है और कौन‑से प्रोसेसिंग रोकने चाहिए।

Position को बिना काल्पनिक Rank बनाए सुरक्षित रखें

position, array index, और request offset को पेजों को मिलाते समय अलग‑अलग फील्ड्स के रूप में रखें। हर मान अवलोकन के अलग हिस्से का वर्णन करता है।

Array index यह दर्ज करता है कि कोई आइटम लौटाई गई array में कहाँ दिखाई दिया। Returned position वह मान है जो API प्रदान करती है। Request offset यह दर्ज करता है कि आपने कौन‑सा पेज माँगा था। बिना पहले उस position के अर्थ को स्पष्ट किए, किसी offset को position में जोड़ देना offset को दो बार गिनने या ऐसा ranking संकेत देने का कारण बन सकता है जो response ने कभी बताया ही नहीं।

Ads, knowledge graph, और organic रिकॉर्ड्स को एक ही sequence में तब तक न गिनें जब तक आपने वह कस्टम माप स्पष्ट रूप से परिभाषित और मान्य न कर लिया हो। जिस डेवलपर को organic rankings चाहिए, उसे वही संदर्भ सुरक्षित रखना चाहिए जिससे उस सर्च पेज का निरीक्षण किया जा सके जिसने रिकॉर्ड उत्पन्न किया।

भले ही आपके डेटाबेस को केवल कुछ कॉलम चाहिए हों, मूल JSON को अपरिवर्तित रूप में सहेजें। बाद में आपको किसी ऐसे फील्ड की ज़रूरत पड़ सकती है जिसे पहले normalization स्क्रिप्ट ने हटा दिया था, या आपको किसी अनुपस्थित फील्ड और अपनी स्वयं की ट्रांसफ़ॉर्मेशन द्वारा जोड़े गए मान के बीच अंतर करना पड़ सकता है।

URL वर्गीकरण आगे की वैलिडेशन के लिए एक रूटिंग निर्णय होता है; यह अंतिम destination का सबूत नहीं होता। coffee के लिए baseline response में एक ही organic रिकॉर्ड्स में direct link मान और अलग Google redirect_link मान दोनों शामिल थे।
Google शब्द मात्र शामिल है या नहीं, इसकी जाँच करने के बजाय स्कीम, होस्टनेम, और पाथ का निरीक्षण करें। URI component model उन हिस्सों को स्पष्ट रूप से अलग करता है। किसी URL के पाथ के भीतर किसी परिचित ब्रांड नाम का होना यह नहीं दर्शाता कि वह वास्तव में उसी ब्रांड द्वारा होस्ट किया गया है।

उपयोगी वर्गों में शामिल हैं: गायब मान, रिलेटिव लिंक, देखे गए Google इंटरमीडियरी, और एक एबसोल्यूट URL उम्मीदवार। /goto?url=... लिंक में अस्पष्ट मान (opaque values) को जस का तस रखें। एक opaque पैरामीटर ऐसा गंतव्य नहीं होता जिसे आप कोई डिकोडिंग स्कीम अनुमान लगाकर पुनर्प्राप्त कर सकें।

Scrapeless के साथ स्क्रैपिंग शुरू करें

Scrapeless के साथ अपने वेब स्क्रैपिंग और ऑटोमेशन वर्कफ़्लो को बेहतर बनाएं!
आज ही साइन अप करें और पाएं $5 का फ्री क्रेडिट — कोई क्रेडिट कार्ड आवश्यक नहीं।

अपना फ्री क्रेडिट अभी Scrapeless Dashboard में क्लेम करें।

एक सेव किए गए JSON Response को Normalize करें

नीचे दिया गया प्रोग्राम बिना किसी परिणाम URL पर जाए नॉर्मलाइज़्ड रिकॉर्ड तैयार करता है। यह दोनों लिंक फ़ील्ड को सुरक्षित रखता है और बाद की समीक्षा के लिए एक स्थानीय वर्गीकरण संलग्न करता है।

पूर्वापेक्षाएँ हैं Python और एक पूर्ण Google Search response जो serp.json के रूप में सेव हो। API की response ऑब्जेक्ट को ही सेव करें, न कि कोई कस्टम रैपर जिसमें आपका लॉगिंग मेटाडेटा शामिल हो। क्विकस्टार्ट अनुरोध वही response उपलब्ध कराता है। स्क्रिप्ट को normalize_organic.py के रूप में सेव करें और JSON फ़ाइल के साथ python normalize_organic.py चलाएँ।

उदाहरण में सेट किया गया होस्टनेम इस response परिवार में देखे गए Google होस्ट को कवर करता है। इसे जानबूझकर हर Google डोमेन की वैश्विक रजिस्ट्री नहीं बनाया गया है। इसे केवल तब बढ़ाएँ जब आपके वास्तविक responses उस जोड़ को उचित ठहराएँ। अन्य एबसोल्यूट URLs अप्रमाणित उम्मीदवार बने रहते हैं।

python Copy
import json
from pathlib import Path
from urllib.parse import urlsplit


def classify_link(value):
    if not isinstance(value, str) or not value.strip():
        return "missing"
    if value.startswith("/"):
        return "relative_review"
    try:
        parts = urlsplit(value)
        host = (parts.hostname or "").lower()
    except ValueError:
        return "invalid_review"
    if parts.scheme not in ("https", "http") or not host:
        return "invalid_review"
    # These are observed Google hosts, not a global Google-domain registry.
    google_hosts = {"google.com", "www.google.com"}
    if host in google_hosts and parts.path in ("/url", "/goto"):
        return "google_intermediary"
    if host in google_hosts:
        return "google_page_review"
    return "absolute_candidate"


data = json.loads(Path("serp.json").read_text(encoding="utf-8"))
if not isinstance(data, dict) or not isinstance(data.get("organic_results"), list):
    raise ValueError("Expected an object with an organic_results array")
normalized = []
for index, row in enumerate(data["organic_results"], start=1):
    if not isinstance(row, dict):
        raise ValueError(f"Invalid result at index {index}")
    normalized.append({
        "array_index": index,
        "returned_position": row.get("position"),
        "title": row.get("title"),
        "snippet": row.get("snippet"),
        "link": row.get("link"),
        "redirect_link": row.get("redirect_link"),
        "link_state": classify_link(row.get("link")),
    })
Path("organic-normalized.json").write_text(
    json.dumps(normalized, ensure_ascii=False, indent=2), encoding="utf-8"
)
counts = {}
for row in normalized:
    state = row["link_state"]
    counts[state] = counts.get(state, 0) + 1
print(json.dumps({"rows": len(normalized), "link_states": counts}))

Python के URL parsing functions घटकों को अलग करते हैं, लेकिन केवल पार्स करना भरोसे या नेटवर्क पर पहुंचने की क्षमता (reachability) को मान्य नहीं करता। इसलिए स्क्रिप्ट की absolute_candidate स्थिति का मतलब बिल्कुल यही है: एक एबसोल्यूट HTTP URL जिसके साथ एक होस्टनेम मौजूद था।

तय करें कि Final URL कब आवश्यक है

जब आपका निष्कर्ष गंतव्य पेज की पहचान पर निर्भर हो, तभी Final-URL सत्यापन आवश्यक हो जाता है। कीवर्ड खोज (keyword discovery) एक उम्मीदवार लिंक को बाद की जाँच के लिए रख सकती है; जबकि लक्ष्य डोमेन रैंकिंग, एट्रीब्यूशन, और संदर्भ (citation) की डिलीवरी के लिए अधिक मजबूत प्रमाण चाहिए।

Downstream Task What the Returned Link Can Support Additional Work
Topic discovery स्निपेट के बगल में एक स्रोत उम्मीदवार दावों पर निर्भर होने से पहले पेज की समीक्षा करें
Search-response audit API द्वारा लौटाया गया लिंक टेक्स्ट आवश्यकता होने पर मूल response और HTML सुरक्षित रखें
Domain matching प्रारंभिक उम्मीदवार वर्गीकरण गंतव्य डोमेन को resolve और validate करें
Verified citation एक उम्मीदवार संदर्भ Final URL, सुलभ सामग्री, और दावा समर्थन की जाँच करें

यदि आप कोई destination resolver बनाते हैं, तो मूल URL और Final URL को अलग-अलग कॉलम के रूप में रखें। रीडायरेक्ट चेन और resolution परिणाम रिकॉर्ड करें। Scrapeless API कुंजी को result वेबसाइट्स पर न भेजें, और किसी नेटवर्क विफलता को यह प्रमाण न मानें कि पेज अस्तित्व में नहीं है।

क्वेरी पैरामीटर्स को अंधाधुंध हटाने से बचें। कुछ पैरामीटर्स किसी पेज की पहचान का हिस्सा होते हैं। यहाँ तक कि एक trailing स्लैश हटाने से भी ऐसे URLs एक साथ मिल सकते हैं जिन्हें origin अलग तरह से ट्रीट करता है। रूढ़िवादी तुलना नियमों से शुरू करें, फिर अपने डेटा सेट द्वारा उपयोग की जाने वाली किसी भी normalization नीति को दस्तावेज़ित करें।

गायब या अप्रत्याशित फ़ील्ड्स का निदान करें

Field-quality रिपोर्ट को यह दिखाना चाहिए कि वास्तव में क्या आया, न कि चुपचाप काल्पनिक वैल्यू बना दे। नॉन-एम्प्टी स्ट्रिंग्स की गिनती उन keys से अलग करें जो केवल मौजूद हैं।

snippet के लिए, एक छोड़ी गई key, null मान, खाली स्ट्रिंग, और नॉन-एम्प्टी टेक्स्ट के बीच अंतर करें। ये अवस्थाएँ तय करती हैं कि कोई row टेक्स्ट विश्लेषण को सहारा दे सकती है या नहीं। यदि किसी row की snippet गायब है, लेकिन उसकी title अभी भी आपके टास्क के लिए उपयोगी है, तो row को रखें, परंतु गायब सामग्री को फ़्लैग करें ताकि कोई विश्लेषक सीमा को समझ सके।

कलेक्शन स्तर पर, अनुपस्थित organic array किसी खाली organic array के बराबर नहीं है। गलत प्रकार की items को या तो किसी strict consumer को रोक देना चाहिए या किसी रिजेक्शन रिपोर्ट में दर्ज होना चाहिए। दोनों में से कोई विकल्प भी शांति से success metric नहीं बढ़ाना चाहिए।

निष्कर्ष: प्रत्येक फ़ील्ड के अर्थ को सुरक्षित रखें

एक भरोसेमंद Google Search API JSON response parser स्रोत फ़ील्ड्स को सुरक्षित रखता है और केवल वही रूपांतरण जोड़ता है जिन्हें वह समझा सके। पोज़िशन, array क्रम, और URL की स्थिति स्पष्ट दिखाई देती है, जबकि असमर्थित गंतव्य अनुमानों को रिकॉर्ड से बाहर रखा जाता है।
Scrapeless Google Search API से शुरू करें, वर्तमान मूल्य निर्धारण के अनुसार संग्रह आवृत्ति चुनें, और डेटाबेस स्कीमा पर प्रतिबद्ध होने से पहले कुछ सहेजे गए रेस्पॉन्स को मान्य करें।

अपना सर्च डेटा वर्कफ़्लो बनाएं

हमारे समुदाय में सर्च डेटा के साथ काम करने वाले डेवलपर्स से जुड़ें: Discord · Telegram.

एक Scrapeless अकाउंट बनाएं और किसी बड़ी कलेक्शन को शेड्यूल करने से पहले इस ट्यूटोरियल को एक छोटे क्वेरी सेट पर लागू करें।

FAQ

प्रश्न: क्या organic_results में SERP के हर दिखने वाले सेक्शन शामिल होते हैं?

नहीं। अन्य सर्च फीचर अलग-अलग रेस्पॉन्स सेक्शन में दिखाई दे सकते हैं। एक ऑर्गेनिक-ऐरे पार्सर को उन मॉड्यूल्स को चुपचाप शामिल नहीं करना चाहिए।

प्रश्न: क्या position आइटम के ऐरे इंडेक्स के समान होती है?

मान कर न चलें कि वे अदला-बदली योग्य हैं। लौटाई गई position और ऐरे इंडेक्स को अलग-अलग रखें, खासकर पेजिनेटेड रिक्वेस्ट्स के बीच।

प्रश्न: क्या redirect_link को link की जगह लेनी चाहिए?

नहीं। दोनों को, जब उपस्थित हों, संरक्षित रखें। वास्तविक URL की स्थिति और अपने डाउनस्ट्रीम टास्क के आधार पर किसी डेस्टिनेशन-प्रोसेसिंग नीति का चयन करें।

प्रश्न: क्या एक एन्कोडेड Google लिंक को एक डिकोडेड डेस्टिनेशन के रूप में माना जा सकता है?

नहीं। अपारदर्शी मानों को संरक्षित रखें और जब अंतिम डेस्टिनेशन पहचान की आवश्यकता हो, तो एक सत्यापित रेज़ोल्यूशन प्रक्रिया का उपयोग करें।

प्रश्न: क्या नॉनएम्प्टी snippet यह साबित करता है कि सारांश सटीक है?

नहीं। नॉनएम्प्टी टेक्स्ट फ़ील्ड उपलब्धता को मापता है। सटीकता और दावे के समर्थन के लिए स्रोत सामग्री का निरीक्षण आवश्यक है।

प्रश्न: क्या नॉर्मलाइज़ेशन के लिए किसी AI एजेंट या अलग प्रॉक्सी की ज़रूरत होती है?

नहीं। यह नॉर्मलाइज़ेशन स्क्रिप्ट सहेजे गए JSON पर कार्य करती है और कोई नेटवर्क रिक्वेस्ट नहीं करती।

स्क्रैपलेस में, हम केवल सार्वजनिक रूप से उपलब्ध डेटा का उपयोग करते हैं, जबकि लागू कानूनों, विनियमों और वेबसाइट गोपनीयता नीतियों का सख्ती से अनुपालन करते हैं। इस ब्लॉग में सामग्री केवल प्रदर्शन उद्देश्यों के लिए है और इसमें कोई अवैध या उल्लंघन करने वाली गतिविधियों को शामिल नहीं किया गया है। हम इस ब्लॉग या तृतीय-पक्ष लिंक से जानकारी के उपयोग के लिए सभी देयता को कोई गारंटी नहीं देते हैं और सभी देयता का खुलासा करते हैं। किसी भी स्क्रैपिंग गतिविधियों में संलग्न होने से पहले, अपने कानूनी सलाहकार से परामर्श करें और लक्ष्य वेबसाइट की सेवा की शर्तों की समीक्षा करें या आवश्यक अनुमतियाँ प्राप्त करें।

सबसे लोकप्रिय लेख

सूची