شكل الاستجابة
يُعيد البحث الناجح 200 مع كائن JSON:
{ "search": "mount everest", "page": 1, "knowledgeGraph": { "title": "Mount Everest", "description": "Earth's highest mountain above sea level…", "attributes": { "Elevation": "8,849 m", "First ascent": "1953" } }, "organic": [ { "position": 1, "title": "Mount Everest - Wikipedia", "link": "https://en.wikipedia.org/wiki/Mount_Everest", "snippet": "Mount Everest is Earth's highest mountain…", "sitelinks": [{ "title": "Height", "link": "https://…" }] } ], "ads": [ { "position": 1, "title": "Everest Treks", "link": "https://…", "block": "top" } ], "peopleAlsoAsk": ["How tall is Mount Everest?"], "relatedSearches": [{ "query": "k2 mountain" }], "stats": { "balance": 9988, "cost": 6, "cached": false }}الحقول ذات المستوى الأعلى
Section titled “الحقول ذات المستوى الأعلى”| الحقل | النوع | ملاحظات |
|---|---|---|
search | string | الاستعلام الذي تم تنفيذه. |
page | integer | الصفحة المُعادة (مفهرسة من 1). |
organic | array | النتائج العضوية المُرتّبة. |
ads | array? | النتائج المدعومة، عند وجودها. |
knowledgeGraph | object? | لوحة كيان Google، عند وجودها. |
peopleAlsoAsk | string[]? | أسئلة “يسأل الناس أيضاً”. |
relatedSearches | array? | ”يبحث الناس أيضاً عن”. |
stats | object? | معلومات الفوترة — انظر التسعير. |
OrganicResult
Section titled “OrganicResult”position، title، link، snippet، وdate اختياري، وsitelinks[] { title, link } اختياري.
position، title، link، وdisplayedLink اختياري، وsnippet اختياري، وblock ("top" أو
"bottom")، وsitelinks[] اختياري.
KnowledgeGraph
Section titled “KnowledgeGraph”title، وimageUrl اختياري، وdescription، وdescriptionSource، وdescriptionLink، وخريطة
attributes من حقائق مفتاح/قيمة.
للاطلاع على المخطط الشامل والمُحدّث دائماً (بما في ذلك كل شكل خطأ)، انظر مرجع الواجهة البرمجية، المُولّد من عقد OpenAPI.