Felo API PlatformFelo API Platform
همه endpointهای DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Google Organic SERP پیشرفته زنده

Felo API Support
MIT
سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO عملیات

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 است.

بدنه
application/json
  • نوع: array (object | null)[]
    • browser_screen_height
      نوع: integer | null

      ارتفاع صفحه نمایش مرورگر فیلد اختیاری می‌توانید ارتفاع صفحه نمایش مرورگر را برای محاسبه رتبه‌بندی پیکسلی یک دستگاه خاص سفارشی کنید؛ می‌توان آن را در بازه زیر مشخص کرد: 240-9999؛ مقدار پیش‌فرض: 1080 برای رایانه رومیزی؛ 640 برای موبایل در android؛ 812 برای موبایل در iOS؛ نکته: برای استفاده از این پارامتر، calculate_rectangles را روی true تنظیم کنید

    • browser_screen_resolution_ratio
      نوع: integer | null

      ضریب مقیاس صفحه نمایش مرورگر فیلد اختیاری می‌توانید ضریب مقیاس صفحه نمایش مرورگر را برای محاسبه رتبه‌بندی پیکسلی یک دستگاه خاص سفارشی کنید؛ می‌توان آن را در بازه زیر مشخص کرد: 0.5-3؛ مقدار پیش‌فرض: 1 برای رایانه رومیزی؛ 3 برای موبایل در android؛ 3 برای موبایل در iOS؛ نکته: برای استفاده از این پارامتر، calculate_rectangles را روی true تنظیم کنید

    • browser_screen_width
      نوع: integer | null قالب: int64

      عرض صفحه نمایش مرورگر فیلد اختیاری می‌توانید عرض صفحه نمایش مرورگر را برای محاسبه رتبه‌بندی پیکسلی یک دستگاه خاص سفارشی کنید؛ می‌توان آن را در بازه زیر مشخص کرد: 240-9999؛ مقدار پیش‌فرض: 1920 برای رایانه رومیزی؛ 360 برای موبایل در android؛ 375 برای موبایل در iOS؛ نکته: برای استفاده از این پارامتر، calculate_rectangles را روی true تنظیم کنید

    • calculate_rectangles
      نوع: boolean | null

      محاسبه رتبه‌بندی پیکسلی برای عناصر SERP در نتایج پیشرفته فیلد اختیاری رتبه‌بندی پیکسلی به فاصله بین قطعه نتیجه و گوشه بالا سمت چپ صفحه اشاره دارد؛ برای اطلاعات بیشتر به مرکز راهنمایی مراجعه کنید>> به‌طور پیش‌فرض، این پارامتر روی false تنظیم شده است؛ نکته: برای استفاده از این پارامتر 0.002 دلار هزینه اضافی از شما دریافت می‌شود

    • depth
      نوع: integer | null

      عمق تجزیه فیلد اختیاری تعداد نتایج در SERP مقدار پیش‌فرض: 10 حداکثر مقدار: 200 حساب شما برای هر SERP حاوی حداکثر 10 نتیجه صورت‌حساب می‌شود؛ تنظیم عمق بیشتر از 10 ممکن است در صورت بازگرداندن بیش از 10 نتیجه توسط موتور جستجو، هزینه‌های اضافی ایجاد کند؛ هزینه را می‌توان در صفحه قیمت‌گذاری محاسبه کرد.

    • device
      نوع: string | null

      نوع دستگاه فیلد اختیاری برگرداندن نتایج برای نوع دستگاه مشخص می‌تواند مقادیر زیر را داشته باشد: desktop، mobile مقدار پیش‌فرض: desktop

    • find_targets_in
      نوع: array string[] | null

      انواع عناصر 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_organic_results
      نوع: boolean | null

      نمایش نتایج مرتبط فیلد اختیاری اگر روی true تنظیم شود، عنصر related_result در پاسخ به‌صورت قطعه‌ای از نتیجه organic والد آن ارائه می‌شود؛ اگر روی false تنظیم شود، عنصر related_result به‌صورت یک نتیجه organic جداگانه ارائه می‌شود؛ مقدار پیش‌فرض: true

    • ignore_targets_in
      نوع: array string[] | null

      انواع عناصر 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 در APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید

    • language_code
      نوع: string | null

      کد زبان موتور جستجو فیلد اختیاری اگر language_name را مشخص می‌کنید اگر از این فیلد استفاده کنید، نیازی به مشخص کردن language_name ندارید می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_code آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/google/languages دریافت کنید مثال: en

    • language_name
      نوع: string | null

      نام کامل زبان موتور جستجو فیلد اختیاری اگر language_code را مشخص می‌کنید اگر از این فیلد استفاده کنید، نیازی به مشخص کردن language_code ندارید می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/google/languages دریافت کنید مثال: English

    • load_async_ai_overview
      نوع: boolean | null

      بارگذاری نمای کلی AI به‌صورت ناهمگام فیلد اختیاری برای دریافت موارد ai_overview در SERP حتی اگر به‌صورت ناهمگام بارگذاری شوند، آن را روی true تنظیم کنید؛ اگر روی false تنظیم شود، موارد ai_overview را فقط از حافظه نهان دریافت می‌کنید؛ مقدار پیش‌فرض: false نکته: برای استفاده از این پارامتر 0.002 دلار هزینه اضافی از شما دریافت می‌شود؛ اگر عنصر وجود نداشته باشد یا شامل "asynchronous_ai_overview": false باشد، همه هزینه‌های اضافی به موجودی حساب شما بازگردانده می‌شود

    • location_code
      نوع: integer | null

      کد موقعیت موتور جستجو فیلد الزامی اگر location_name یا location_coordinate را مشخص نکنید اگر از این فیلد استفاده کنید، نیازی به مشخص کردن location_name یا location_coordinate ندارید می‌توانید فهرست موقعیت‌های موجود موتورهای جستجو را همراه با location_code آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/google/locations دریافت کنید مثال: 2840

    • location_coordinate
      نوع: string | null

      مختصات 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_name
      نوع: string | null

      نام کامل موقعیت موتور جستجو فیلد الزامی اگر location_code یا location_coordinate را مشخص نکنید اگر از این فیلد استفاده کنید، نیازی به مشخص کردن location_code یا location_coordinate ندارید می‌توانید فهرست موقعیت‌های موجود موتور جستجو را همراه با location_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/google/locations دریافت کنید مثال: London,England,United Kingdom

    • match_type
      نوع: string | null

      نوع تطبیق هدف فیلد الزامی اگر stop_crawl_on_match مشخص شده باشد نوع تطبیق برای match_value مقادیر ممکن: domain – دامنه یا زیردامنه مشخص with_subdomains – دامنه اصلی و زیردامنه‌ها wildcard – الگوی نویسه عام

    • match_value
      نوع: string | null

      مقدار هدف از نوع دامنه، زیردامنه یا نویسه عام فیلد الزامی اگر stop_crawl_on_match مشخص شده باشد یک دامنه، زیردامنه یا مقدار نویسه عام هدف مشخص کنید؛ نکته: دامنه یا زیردامنه باید بدون پروتکل درخواست مشخص شود؛ مثال: "match_value": "dataforseo.com"،"match_value": "/blog/post-*"

    • max_crawl_pages
      نوع: integer | null

      حد خزش صفحات فیلد اختیاری تعداد صفحات نتایج جستجو برای خزش حداکثر مقدار: 100 نکته: برای هر صفحه خزش‌شده از شما هزینه دریافت می‌شود (10 نتیجه ارگانیک در هر صفحه)؛ درباره قیمت‌گذاری در صفحه قیمت‌گذاری بیشتر بدانید؛ نکته#2: پارامترهای max_crawl_pages و depth مکمل یکدیگرند؛ در مرکز راهنمایی ما بیشتر بدانید

    • os
      نوع: string | null

      سیستم‌عامل دستگاه فیلد اختیاری اگر desktop را در فیلد device مشخص کنید، از مقادیر زیر انتخاب کنید: windows، macos مقدار پیش‌فرض: windows اگر mobile را در فیلد device مشخص کنید، از مقادیر زیر انتخاب کنید: android، ios مقدار پیش‌فرض: android

    • people_also_ask_click_depth
      نوع: integer | null

      کلیک‌ها روی عنصر مربوطه فیلد اختیاری عمق کلیک روی عنصر people_also_ask را مشخص کنید تا موارد people_also_ask_element بیشتری دریافت کنید؛ نکته: برای هر کلیک 0.00015 دلار اضافی از حساب شما دریافت می‌شود؛ اگر عنصر وجود نداشته باشد یا کلیک‌های کمتری از آنچه مشخص کرده‌اید انجام دهیم، همه هزینه‌های اضافی به موجودی حساب شما بازگردانده می‌شود مقادیر ممکن: از 1 تا 4

    • remove_from_url
      نوع: array string[] | null

      حذف پارامترهای مشخص از نشانی‌های URL فیلد اختیاری با استفاده از این فیلد، می‌توانید حداکثر 10 پارامتر را برای حذف از نشانی‌های URL در نتیجه مشخص کنید مثال: "remove_from_url": ["srsltid"] نکته: اگر فیلد target مشخص شود، پارامترهای URL مشخص‌شده پیش از جستجو حذف می‌شوند

    • se_domain
      نوع: string | null

      دامنه موتور جستجو فیلد اختیاری دامنه مرتبط موتور جستجو را بر اساس موقعیت و زبانی که مشخص می‌کنید به‌صورت خودکار انتخاب می‌کنیم با این حال، می‌توانید در این فیلد دامنه موتور جستجوی سفارشی تنظیم کنید مثال: google.co.uk، google.com.au، google.de و غیره.

    • search_param
      نوع: string | null

      پارامترهای اضافی پرس‌وجوی جستجو فیلد اختیاری فهرست پارامترهای موجود و جزئیات بیشتر را اینجا دریافت کنید نکته: پارامترهای زیر موتور جستجو پشتیبانی نمی‌شوند و در صورت مشخص شدن به‌صورت خودکار لغو می‌شوند: lr، cr، as_qdr، as_sitesearch، as_occt، as_filetype.

    • stop_crawl_on_match
      نوع: array (object | null)[] | null

      آرایه‌ای از اهداف برای توقف خزش فیلد اختیاری در صورت تعیین، پاسخ شامل نتایج 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_type
        نوع: string | null

        نوع مطابقت هدف فیلد الزامی اگر stop_crawl_on_match تعیین شده باشد؛ نوع مطابقت برای match_value مقادیر ممکن: domain، with_subdomains، wildcard

      • match_value
        نوع: string | null

        دامنه هدف یا مقدار نویسه عام فیلد الزامی اگر stop_crawl_on_match تعیین شده باشد؛ دامنه هدف یا مقدار نویسه عام را مشخص کنید؛ توجه: نام دامنه باید بدون پروتکل درخواست مشخص شود؛ مثال: dataforseo.com

    • tag
      نوع: string | null

      شناسه وظیفه تعریف‌شده توسط کاربر. فیلد اختیاری. محدودیت نویسه 255 است. می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید. مقدار tag مشخص‌شده را در شیء data در پاسخ پیدا می‌کنید.

    • target
      نوع: string | null

      دامنه، زیردامنه یا صفحه وبی که برای آن نتیجه دریافت می‌کنید فیلد اختیاری دامنه یا زیردامنه باید بدون https:// و www. مشخص شود توجه داشته باشید که نتایج وظایف مخصوص target فقط شامل عناصر SERP حاوی رشته url خواهد بود؛ همچنین می‌توانید از کاراکتر نویسه عام (‘’) برای مشخص کردن الگوی جستجو در SERP و محدود کردن نتایج استفاده کنید؛ مثال‌ها: example.com - نتایج را برای صفحه اصلی وب‌سایت با نشانی‌هایی مانند 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_search_mode
      نوع: string | null

      حالت تطبیق هدف فیلد اختیاری برای فعال کردن این پارامتر، 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.

پاسخ‌ها
  • 200
    نوع: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo
    • cost
      نوع: number | null قالب: double

      هزینه کل وظایف، دلار آمریکا

    • status_code
      نوع: integer | null

      کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

    • status_message
      نوع: string | null

      پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

    • tasks
      نوع: array (object | null)[] | null

      آرایه وظایف

      • نوع: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
        • cost
          نوع: number | null قالب: double

          هزینه کل وظایف، دلار آمریکا

        • data
          نوع: object | null

          همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید

          • propertyName
            نوع: object | null
        • id
          نوع: string | null

          شناسه وظیفه شناسه یکتای وظیفه در سیستم ما در قالب UUID

        • path
          نوع: array (string | null)[] | null

          مسیر URL

        • result
          نوع: array (object | null)[] | null

          آرایه نتایج

          • check_url
            نوع: string | null

            نشانی URL مستقیم نتایج موتور جستجومیتوانید از آن استفاده کنید تا مطمئن شوید نتایج دقیقی ارائه کرده‌ایم

          • datetime
            نوع: string | null

            تاریخ و زمان دریافت نتیجهدر قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”مثال:2019-11-15 12:57:46 +00:00

          • item_types
            نوع: array (string | null)[] | null

            انواع نتایج جستجو در 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 است
              اگر calculate_rectangles در درخواست POST روی true تنظیم نشود، برابر null است

              • 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_count
            نوع: integer | null قالب: int64

            تعداد نتایج برگشتی در آرایه items

          • keyword
            نوع: string | null

            کلمه کلیدی دریافت‌شده در آرایه POST کلمه کلیدی با %## رمزگشایی‌شده بازگردانده می‌شود (نویسه + به فاصله رمزگشایی می‌شود)

          • language_code
            نوع: string | null

            کد زبان در آرایه POST

          • location_code
            نوع: integer | null

            کد مکان در آرایه POST

          • pages_count
            نوع: integer | null قالب: int64

            تعداد کل صفحات نتایج جستجوی بازیابی‌شده تعداد کل نتایج SERP بازیابی‌شده در نتیجه

          • refinement_chips
            نوع: object | null · Response36Afe1097B20_RefinementChipsInfo

            تراشه‌های پالایش جستجو

            • 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_domain
            نوع: string | null

            دامنه موتور جستجو در آرایه POST

          • se_results_count
            نوع: integer | null قالب: int64

            تعداد کل نتایج در 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_count
          نوع: integer | null قالب: int64

          تعداد عناصر در آرایه result

        • status_code
          نوع: integer | null

          کد وضعیت وظیفه توسط DataForSEO تولید می‌شود و می‌تواند در بازه زیر باشد: 10000-60000 فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

        • status_message
          نوع: string | null

          پیام اطلاعاتی وظیفه فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

        • time
          نوع: string | null

          زمان اجرا، ثانیه

    • tasks_count
      نوع: integer | null قالب: int64

      تعداد وظایف در آرایه tasks

    • tasks_error
      نوع: integer | null قالب: int64

      تعداد وظایف در آرایه tasks که با خطا برگردانده شده‌اند

    • time
      نوع: string | null

      زمان کل اجرا، بر حسب ثانیه

    • version
      نوع: string | null

      نسخه فعلی API

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for post/v1/beta/dataforseo/serp/google/organic/live/advanced
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]"
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Live Google Organic SERP Advanced