DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Organic SERP المتقدم المباشر
يعيد النتائج المرتّبة لكلمة مفتاحية على Google بشكل متزامن. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. advanced هو الخيار الافتراضي؛ خذ regular عندما تكون القائمة المرتّبة هي كل المهمة، وhtml فقط للتحقق مما أسقطه المحلّل. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.0175 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- browserالنوع: integer | null
_screen _height ارتفاع شاشة المتصفح حقل اختياري يمكنك تعيين ارتفاع مخصص لشاشة المتصفح لحساب ترتيب البكسل لجهاز معيّن؛ يمكن تحديده ضمن النطاق التالي: 240-9999؛ القيمة الافتراضية: 1080 لسطح المكتب؛ 640 للجوال على android؛ 812 للجوال على iOS؛ ملاحظة: لاستخدام هذا المعامل، عيّن calculate_rectangles على true
- browserالنوع: integer | null
_screen _resolution _ratio عامل تحجيم شاشة المتصفح حقل اختياري يمكنك تعيين عامل تحجيم مخصص لشاشة المتصفح لحساب ترتيب البكسل لجهاز معيّن؛ يمكن تحديده ضمن النطاق التالي: 0.5-3؛ القيمة الافتراضية: 1 لسطح المكتب؛ 3 للجوال على android؛ 3 للجوال على iOS؛ ملاحظة: لاستخدام هذا المعامل، عيّن calculate_rectangles على true
- browserالنوع: integer | null التنسيق: int64
_screen _width عرض شاشة المتصفح حقل اختياري يمكنك تعيين عرض مخصص لشاشة المتصفح لحساب ترتيب البكسل لجهاز معيّن؛ يمكن تحديده ضمن النطاق التالي: 240-9999؛ القيمة الافتراضية: 1920 لسطح المكتب؛ 360 للجوال على android؛ 375 للجوال على iOS؛ ملاحظة: لاستخدام هذا المعامل، عيّن calculate_rectangles على true
- calculateالنوع: boolean | null
_rectangles حساب ترتيب البكسل لعناصر SERP في النتائج المتقدمة حقل اختياري يشير ترتيب البكسل إلى المسافة بين مقتطف النتيجة والزاوية العلوية اليسرى للشاشة؛ زُر مركز المساعدة لمعرفة المزيد>> افتراضيًا، يُضبط المعامل على false؛ ملاحظة: ستُفرض عليك رسوم إضافية بقيمة 0.002 دولار أمريكي لاستخدام هذا المعامل
- depthالنوع: integer | null
عمق التحليل حقل اختياري عدد النتائج في SERP القيمة الافتراضية: 10 القيمة القصوى: 200 ستُحتسب رسوم حسابك لكل SERP يحتوي على ما يصل إلى 10 نتائج؛ قد يؤدي تعيين عمق أكبر من 10 إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 10 نتائج؛ يمكن حساب التكلفة في صفحة الأسعار.
- deviceالنوع: string | null
نوع الجهاز حقل اختياري إعادة النتائج لنوع جهاز محدد يمكن أن تأخذ القيم: desktop، mobile القيمة الافتراضية: desktop
- findالنوع: array string[] | null
_targets _in أنواع عناصر SERP للتحقق من الأهداف حقل اختياري لتفعيل هذا المعامل، يجب أيضًا تفعيل stop_crawl_on_match يحدد أنواع عناصر SERP التي يجب التحقق فيها بحثًا عن مطابقات الأهداف إذا لم يُحدد، تُفحص جميع عناصر المستوى الأول التي تحتوي على حقلي url وdomain بحثًا عن الأهداف القيم الممكنة: organic، paid، local_pack، featured_snippet، events، google_flights، images، jobs، knowledge_graph، local_service، map، scholarly_articles، third_party_reviews، twitter ملاحظة: لا يمكن أن يحتوي على أنواع العناصر نفسها الموجودة في ignore_targets_in مثال: "find_targets_in": ["organic", "featured_snippet"] اعرف المزيد عن هذا المعامل في مركز المساعدة
- groupالنوع: boolean | null
_organic _results عرض النتائج ذات الصلة حقل اختياري إذا ضُبط على true، سيُقدَّم عنصر related_result في الاستجابة كمقتطف من نتيجة organic الأصلية التابعة له؛ إذا ضُبط على false، سيُقدَّم عنصر related_result كنتيجة organic منفصلة؛ القيمة الافتراضية: true
- ignoreالنوع: array string[] | null
_targets _in أنواع عناصر SERP المستبعدة من البحث عن الأهداف حقل اختياري لتفعيل هذا المعامل، يجب أيضًا تفعيل stop_crawl_on_match يحدد أنواع عناصر SERP التي يجب استبعادها عند البحث عن مطابقات الأهداف القيم الممكنة: organic، paid، local_pack، featured_snippet، events، google_flights، images، jobs، knowledge_graph، local_service، map، scholarly_articles، third_party_reviews، twitter ملاحظة: لا يمكن أن يحتوي على أنواع العناصر نفسها الموجودة في find_targets_in مثال: "ignore_targets_in": ["paid", "images"] اعرف المزيد عن هذا المعامل في مركز المساعدة
- keywordالنوع: string
الكلمة المفتاحية حقل مطلوب يمكنك تحديد حتى 700 حرف في حقل keyword ستُفكّ جميع ترميزات %## (وسيُفكّ الحرف ‘+’ إلى مسافة) إذا كنت بحاجة إلى استخدام الحرف “%” في keyword، فحدده بالشكل “%25”؛ إذا كنت بحاجة إلى استخدام الحرف “+” في keyword، فحدده بالشكل “%2B”؛ إذا كانت هذه الكلمة تحتوي على معاملات مثل ‘allinanchor:’، ‘allintext:’، ‘allintitle:’، ‘allinurl:’، ‘cache:’، ‘define:’، ‘definition:’، ‘filetype:’، ‘id:’، ‘inanchor:’، ‘info:’، ‘intext:’، ‘intitle:’، ‘inurl:’، ‘link:’، ‘site:’، فستُضرب تكلفة كل مهمة في 5 اعرف المزيد عن قواعد وقيود حقلي keyword وkeywords في واجهات DataForSEO في مقالة مركز المساعدة هذه
- languageالنوع: string | null
_code رمز لغة محرك البحث حقل اختياري إذا حددت language_name إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name يمكنك الحصول على قائمة اللغات المتاحة لمحرك البحث مع language_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/google/languages مثال: en
- languageالنوع: string | null
_name الاسم الكامل للغة محرك البحث حقل اختياري إذا حددت language_code إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code يمكنك الحصول على قائمة اللغات المتاحة لمحرك البحث مع language_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/google/languages مثال: English
- loadالنوع: boolean | null
_async _ai _overview تحميل نظرة AI العامة بشكل غير متزامن حقل اختياري اضبطه على true للحصول على عناصر ai_overview في نتائج SERP حتى إذا حُمّلت بشكل غير متزامن؛ إذا ضُبط على false، فلن تحصل إلا على عناصر ai_overview من ذاكرة التخزين المؤقت؛ القيمة الافتراضية: false ملاحظة: ستُحتسب عليك 0.002 دولار إضافية لاستخدام هذا المعامل؛ إذا كان العنصر غائبًا أو يحتوي على "asynchronous_ai_overview": false، فستُعاد كل الرسوم الإضافية إلى رصيد حسابك
- locationالنوع: integer | null
_code رمز موقع محرك البحث حقل مطلوب إذا لم تحدد location_name أو location_coordinate إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name أو location_coordinate يمكنك الحصول على قائمة المواقع المتاحة لمحركات البحث مع location_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/google/locations مثال: 2840
- locationالنوع: string | null
_coordinate إحداثيات GPS لموقع حقل اختياري إذا حددت location_name أو location_code إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name أو location_code يجب تحديد معامل location_coordinate بصيغة "latitude,longitude,radius" الحد الأقصى لعدد المنازل العشرية في "latitude" و"longitude": 7 الحد الأدنى لقيمة "radius": 199 (مم) الحد الأقصى لقيمة "radius": 199999 (مم) مثال: 53.476225,-2.243572,200
- locationالنوع: string | null
_name الاسم الكامل لموقع محرك البحث حقل مطلوب إذا لم تحدد location_code أو location_coordinate إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_code أو location_coordinate يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع location_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/google/locations مثال: London,England,United Kingdom
- matchالنوع: string | null
_type نوع مطابقة الهدف حقل مطلوب إذا حُدد stop_crawl_on_match نوع المطابقة لقيمة match_value القيم الممكنة: domain – نطاق أو نطاق فرعي محدد with_subdomains – النطاق الرئيسي والنطاقات الفرعية wildcard – نمط حرف البدل
- matchالنوع: string | null
_value قيمة النطاق أو النطاق الفرعي أو حرف البدل المستهدف حقل مطلوب إذا حُدد stop_crawl_on_match حدد نطاقًا أو نطاقًا فرعيًا أو قيمة حرف بدل مستهدفة؛ ملاحظة: يجب تحديد النطاق أو النطاق الفرعي دون بروتوكول طلب؛ مثال: "match_value": "dataforseo.com"،"match_value": "/blog/post-*"
- maxالنوع: integer | null
_crawl _pages حد زحف الصفحات حقل اختياري عدد صفحات نتائج البحث المراد الزحف إليها القيمة القصوى: 100 ملاحظة: ستُحتسب عليك رسوم عن كل صفحة تُزحف (10 نتائج عضوية لكل صفحة)؛ اعرف المزيد عن التسعير في صفحة الأسعار؛ ملاحظة#2: المعاملان max_crawl_pages وdepth يكمّل أحدهما الآخر؛ تعرّف على المزيد في مركز المساعدة
- osالنوع: string | null
نظام تشغيل الجهاز حقل اختياري إذا حددت desktop في حقل device، فاختر من القيم التالية: windows، macos القيمة الافتراضية: windows إذا حددت mobile في حقل device، فاختر من القيم التالية: android، ios القيمة الافتراضية: android
- peopleالنوع: integer | null
_also _ask _click _depth النقرات على العنصر المقابل حقل اختياري حدد عمق النقر على عنصر people_also_ask للحصول على عناصر people_also_ask_element إضافية؛ ملاحظة: ستُحتسب على حسابك 0.00015 دولار إضافية عن كل نقرة؛ إذا كان العنصر غائبًا أو نفّذنا نقرات أقل مما حددت، فستُعاد كل الرسوم الإضافية إلى رصيد حسابك القيم الممكنة: من 1 إلى 4
- removeالنوع: array string[] | null
_from _url إزالة معاملات محددة من عناوين URL حقل اختياري باستخدام هذا الحقل، يمكنك تحديد حتى 10 معاملات لإزالتها من عناوين URL في النتيجة مثال: "remove_from_url": ["srsltid"] ملاحظة: إذا حُدد الحقل target، فستُزال معاملات URL المحددة قبل البحث
- seالنوع: string | null
_domain نطاق محرك البحث حقل اختياري نختار نطاق محرك البحث المناسب تلقائيًا وفقًا للموقع واللغة التي تحددها ومع ذلك، يمكنك تعيين نطاق محرك بحث مخصص في هذا الحقل مثال: google.co.uk، google.com.au، google.de، إلخ.
- searchالنوع: string | null
_param معاملات إضافية لاستعلام البحث حقل اختياري احصل على قائمة المعاملات المتاحة والتفاصيل الإضافية هنا ملاحظة: معاملات محرك البحث التالية غير مدعومة وستُلغى تلقائيًا إذا حُددت: lr، cr، as_qdr، as_sitesearch، as_occt، as_filetype.
- stopالنوع: array (object | null)[] | null
_crawl _on _match مصفوفة أهداف لإيقاف الزحف حقل اختياري إذا حُددت، ستحتوي الاستجابة على نتائج SERP حتى القيمة المطابقة المحددة وشاملة إياها؛ يمكنك تحديد ما يصل إلى 10 قيم هدف في هذه المصفوفة مثال: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] تعرّف على المزيد حول هذا المعامل في مركز المساعدة - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api ستُحتسب رسوم على حسابك عن كل SERP يُزحف عبر الأهداف المحددة
- matchالنوع: string | null
_type نوع مطابقة الهدف حقل مطلوب إذا حُدد stop_crawl_on_match؛ نوع المطابقة لقيمة match_value القيم الممكنة: domain، with_subdomains، wildcard
- matchالنوع: string | null
_value النطاق الهدف أو قيمة wildcard حقل مطلوب إذا حُدد stop_crawl_on_match؛ حدد نطاقًا هدفًا أو قيمة wildcard؛ ملاحظة: يجب تحديد اسم النطاق دون بروتوكول طلب؛ مثال: dataforseo.com
- tagالنوع: string | null
معرّف المهمة الذي يحدده المستخدم. حقل اختياري. حد الأحرف هو 255. يمكنك استخدام هذا المعامل لتعريف المهمة ومطابقتها مع النتيجة. ستجد قيمة tag المحددة في كائن data في الاستجابة.
- targetالنوع: string | null
النطاق أو النطاق الفرعي أو صفحة الويب المستهدفة للحصول على النتائج لها حقل اختياري يجب تحديد نطاق أو نطاق فرعي دون https:// وwww. لاحظ أن نتائج المهام الخاصة بـtarget ستشمل فقط عناصر SERP التي تحتوي على سلسلة url؛ يمكنك أيضًا استخدام حرف بدل (‘’) لتحديد نمط البحث في SERP وتضييق النتائج؛ أمثلة: example.com - يعيد نتائج للصفحة الرئيسية للموقع باستخدام عناوين URL مثل https://example.com، أو https://www.example.com/، أو https://example.com/؛ example.com - يعيد نتائج للنطاق، بما في ذلك جميع صفحاته؛ example.com - يعيد نتائج للنطاق بأكمله، بما في ذلك جميع صفحاته ونطاقاته الفرعية؛ example.com - يعيد نتائج للصفحة الرئيسية بغض النظر عن النطاق الفرعي، مثل https://en.example.com؛ example.com/example-page - يعيد نتائج لعنوان URL الدقيق؛ example.com/example-page - يعيد نتائج لجميع عناوين URL الخاصة بالنطاق التي تبدأ بالسلسلة المحددة
- targetالنوع: string | null
_search _mode وضع مطابقة الأهداف حقل اختياري لتفعيل هذا المعامل، يجب أيضًا تفعيل stop_crawl_on_match يحدد كيف يجب أن يتوقف الزحف عند تحديد أهداف متعددة في stop_crawl_on_match القيم الممكنة: all، any all – لا يتوقف الزحف إلا عند العثور على جميع الأهداف المحددة any – يتوقف الزحف عند العثور على أي هدف واحد القيمة الافتراضية: any اعرف المزيد عن هذا المعامل في مركز المساعدة
- urlالنوع: string | null
عنوان URL المباشر لاستعلام البحث حقل اختياري يمكنك تحديد عنوان URL مباشر وسنقوم بتحليله إلى الحقول اللازمة. لاحظ أن هذه الطريقة هي الأصعب على API لدينا في المعالجة وتتطلب أيضًا تحديد اللغة والموقع بدقة في عنوان URL. في معظم الحالات، لا نوصي باستخدام هذه الطريقة. مثال: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS ملاحظة: معاملات محرك البحث التالية غير مدعومة وستُلغى تلقائيًا إذا حُددت: lr، cr، as_qdr، as_sitesearch، as_occt، as_filetype.
- النوع: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
- costالنوع: number | null التنسيق: double
إجمالي تكلفة المهام، بالدولار الأمريكي
- dataالنوع: object | null
يحتوي على المعاملات نفسها التي حددتها في طلب POST
- propertyالنوع: object | null
Name
- idالنوع: string | null
معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID
- pathالنوع: array (string | null)[] | null
مسار URL
- resultالنوع: array (object | null)[] | null
مصفوفة النتائج
- checkالنوع: string | null
_url عنوان URL مباشر لنتائج محرك البحثيمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة
- datetimeالنوع: string | null
تاريخ ووقت استلام النتيجةبالتنسيق: “yyyy-mm-dd hh-mm-ss +00:00”مثال:2019-11-15 12:57:46 +00:00
- itemالنوع: array (string | null)[] | null
_types أنواع نتائج البحث في SERP تحتوي على أنواع نتائج البحث (items) الموجودة في SERP. أنواع العناصر الممكنة: answer_box، app، carousel، multi_carousel، featured_snippet، google_flights، google_reviews، third_party_reviews، images، jobs، knowledge_graph، local_pack، hotels_pack، map، organic، paid، people_also_ask، related_searches، people_also_search، shopping، top_stories، twitter، video، events، recipes، top_sights، scholarly_articles، popular_products، questions_and_answers، find_results_on، stocks_box، commercial_units، local_services، google_hotels، math_solver، currency_box، product_considerations، short_videos، refine_products، perspectives، discussions_and_forums، compare_sites، ai_overview
- itemsالنوع: array (object | null)[] | null
العناصر التابعة للعنصر
- pageالنوع: integer | null
رقم صفحة نتائج البحث
يشير إلى رقم صفحة SERP التي يقع فيها العنصر - positionالنوع: string | null
محاذاة العنصر في SERP
يمكن أن تأخذ القيم التالية:left،right - rectangleالنوع: object | null · Response36Afe1097B20_AiModeRectangleInfo
معاملات المستطيل
تحتوي على الإحداثيات الديكارتية وأبعاد البكسل لمقتطف النتيجة في SERP
تساويnullإذا لم يُضبطcalculate_rectanglesفي طلب POST علىtrue- heightالنوع: number | null التنسيق: double
ارتفاع العنصر بالبكسل
- widthالنوع: number | null التنسيق: double
عرض العنصر بالبكسل
- xالنوع: number | null التنسيق: double
إحداثي المحور x إحداثي المحور x للزاوية العلوية اليسرى من مقتطف النتيجة، حيث تكون الزاوية العلوية اليسرى للشاشة هي نقطة الأصل
- yالنوع: number | null التنسيق: double
إحداثي المحور y إحداثي المحور y للزاوية العلوية اليسرى من مقتطف النتيجة، حيث تكون الزاوية العلوية اليسرى للشاشة هي نقطة الأصل
- typeالنوع: string | null
نوع العنصر
- xpathالنوع: string | null
XPath الخاص بالعنصر
- itemsالنوع: integer | null التنسيق: int64
_count عدد النتائج المعادة في مصفوفة items
- keywordالنوع: string | null
الكلمة المفتاحية المستلمة في مصفوفة POST تُعاد الكلمة المفتاحية مع فك ترميز %## (سيُفكّ ترميز الرمز '+' إلى مسافة)
- languageالنوع: string | null
_code رمز اللغة في مصفوفة POST
- locationالنوع: integer | null
_code رمز الموقع في مصفوفة POST
- pagesالنوع: integer | null التنسيق: int64
_count إجمالي صفحات نتائج البحث المستردّة العدد الإجمالي لنتائج SERP المستردّة في النتيجة
- refinementالنوع: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips شرائح تنقية البحث
- itemsالنوع: array (object | null)[] | null
العناصر التابعة للعنصر
- domainالنوع: string | null
النطاق في SERP
- optionsالنوع: array (object | null)[] | null
خيارات تحسين البحث الإضافية
- domainالنوع: string | null
النطاق في SERP
- titleالنوع: string | null
عنوان العنصر
- typeالنوع: string | null
نوع العنصر
- urlالنوع: string | null
عنوان URL للبحث مع معاملات التنقية
- titleالنوع: string | null
عنوان العنصر
- typeالنوع: string | null
نوع العنصر
- urlالنوع: string | null
عنوان URL للبحث مع معاملات التنقية
- typeالنوع: string | null
نوع العنصر
- xpathالنوع: string | null
XPath الخاص بالعنصر
- seالنوع: string | null
_domain نطاق محرك البحث في مصفوفة POST
- seالنوع: integer | null التنسيق: int64
_results _count العدد الإجمالي للنتائج في SERP
- spellالنوع: object | null · Response36Afe1097B20_SpellInfo
التصحيح التلقائي لمحرك البحثإذا قدّم محرك البحث نتائج لكلمة مفتاحية جرى تصحيحها، فسنحدد الكلمة المفتاحية التي صححها محرك البحث ونوع التصحيح التلقائي
- keywordالنوع: string | null
الكلمة المفتاحية التي تم الحصول عليها نتيجة التصحيح التلقائي لمحرك البحث ستُقدَّم النتائج للكلمة المفتاحية المصححة
- typeالنوع: string | null
نوع التصحيح التلقائي القيم الممكنة: did_you_mean, showing_results_for, no_results_found_for, including_results_for ملاحظة: يدعم Yahoo وYandex نوع التصحيح التلقائي التالي فقط: including_results_for
- typeالنوع: string | null
نوع العنصر
- resultالنوع: integer | null التنسيق: int64
_count عدد العناصر في مصفوفة result
- statusالنوع: integer | null
_code رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- statusالنوع: string | null
_message الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- timeالنوع: string | null
وقت التنفيذ، بالثواني
- النوع: integer | null التنسيق: int64tasks
_count عدد المهام في مصفوفة tasks
- النوع: integer | null التنسيق: int64tasks
_error عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ
- النوع: string | nulltime
إجمالي وقت التنفيذ، بالثواني
- النوع: string | nullversion
الإصدار الحالي من API
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein",
"calculate_rectangles": true
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}