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

Google Local Finder 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 Local Finder SERP زنده

​

نتایج محلی گسترده‌ای را که Google وقتی یک پرس‌وجو به‌وضوح محلی است در 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.02 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

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

      عمق تجزیه

      فیلد اختیاری

      تعداد نتایج در SERP

      مقدار پیش‌فرض: 10

      حداکثر مقدار: 100


      حساب شما برای هر SERP حاوی حداکثر 10 نتیجه صورت‌حساب می‌شود؛

      تعیین عمق بیش از 10 در صورت بازگرداندن بیش از 10 نتیجه توسط موتور جستجو ممکن است هزینه اضافی ایجاد کند به‌ترتیب؛

      اگر عمق تعیین‌شده بیشتر از تعداد نتایج در پاسخ باشد، تفاوت به‌طور خودکار به موجودی حساب شما بازگردانده می‌شود

      هزینه را می‌توان در صفحه قیمت‌گذاری محاسبه کرد.

    • device
      نوع: string | null

      نوع دستگاه

      فیلد اختیاری

      برگرداندن نتایج برای نوع دستگاه مشخص

      می‌تواند مقادیر زیر را داشته باشد:desktop، mobile

      مقدار پیش‌فرض: desktop

    • keyword
      نوع: string

      کلمه کلیدی

      فیلد الزامی

      می‌توانید حداکثر 700 کاراکتر در فیلد keyword مشخص کنید

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

      اگر باید از کاراکتر "%" برای keyword استفاده کنید، آن را به‌صورت "%25" مشخص کنید؛

      اگر باید از کاراکتر "+" برای keyword استفاده کنید، آن را به‌صورت "%2B" مشخص کنید


      درباره قواعد و محدودیت‌های فیلدهای keyword و keywords در APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید

    • language_code
      نوع: string

      کد زبان موتور جستجو

      فیلد الزامی اگر تعیین نکنید language_name

      اگر از این فیلد استفاده کنید، نیازی به تعیین language_name نیست

      می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_code آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages دریافت کنید

      مثال:en

    • language_name
      نوع: string

      نام کامل زبان موتور جستجو

      فیلد الزامی اگر تعیین نکنید language_code

      اگر از این فیلد استفاده کنید، نیازی به تعیین language_code نیست

      می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_name آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages دریافت کنید

      مثال:

      English

    • location_code
      نوع: integer

      کد موقعیت موتور جستجو

      فیلد الزامی اگر تعیین نکنید location_name یا location_coordinate

      اگر از این فیلد استفاده کنید، نیازی به تعیین location_name یا location_coordinate نیست

      می‌توانید فهرست موقعیت‌های موجود موتورهای جستجو را همراه با location_code آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations دریافت کنید

      مثال:

      2840

    • location_coordinate
      نوع: string

      مختصات GPS یک موقعیت

      فیلد الزامی اگر تعیین نکنید location_name یا location_code

      اگر از این فیلد استفاده کنید، نیازی به تعیین location_name یا location_code نیست

      پارامتر location_coordinate باید در قالب "latitude,longitude,zoom" تعیین شود

      اگر "zoom" تعیین نشود، 9z به‌عنوان مقدار پیش‌فرض اعمال می‌شود

      حداکثر تعداد ارقام اعشار برای "latitude" و "longitude": 7

      حداقل مقدار برای "zoom": 4z

      حداکثر مقدار برای "zoom": 18z

      مثال:

      52.6178549,-155.352142,20z

    • location_name
      نوع: string

      نام کامل موقعیت موتور جستجو

      فیلد الزامی اگر location_code یا location_coordinate را مشخص نکنید

      اگر از این فیلد استفاده کنید، نیازی به مشخص کردن location_code یا location_coordinate ندارید

      می‌توانید فهرست موقعیت‌های موجود موتور جستجو را همراه با location_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations دریافت کنید

      مثال:

      London,England,United Kingdom

    • min_rating
      نوع: number | null قالب: double

      فیلتر نتایج بر اساس حداقل امتیاز

      فیلد اختیاری

      مقادیر ممکن برای desktop: 3.5، 4، 4.5؛

      مقادیر ممکن برای mobile: 2، 2.5، 3، 3.5، 4، 4.5

    • os
      نوع: string | null

      سیستم‌عامل دستگاه

      فیلد اختیاری

      اگر desktop را در فیلد device مشخص کنید، از مقادیر زیر انتخاب کنید: windows، macos

      مقدار پیش‌فرض: windows

      اگر mobile را در فیلد device مشخص کنید، از مقادیر زیر انتخاب کنید: android، ios

      مقدار پیش‌فرض: android

    • priority
      نوع: integer | null

      اولویت وظیفه

      فیلد اختیاری

      می‌تواند مقادیر زیر را داشته باشد:

      1 – اولویت اجرای عادی (به‌صورت پیش‌فرض تنظیم می‌شود)

      2 – اولویت اجرای بالا


      برای وظایف با اولویت اجرای بالا هزینه اضافی از شما دریافت می‌شود.

      هزینه را می‌توان در صفحه قیمت‌گذاری محاسبه کرد.

    • tag
      نوع: string | null

      شناسه وظیفه تعریف‌شده توسط کاربر

      فیلد اختیاری

      محدودیت کاراکتر 255 است

      می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید

      مقدار tag مشخص‌شده را در شیء data پاسخ خواهید یافت

    • time_filter
      نوع: string | null

      فیلتر نتایج بر اساس ساعات کاری

      فیلد اختیاری

      با استفاده از این فیلد می‌توانید مکان‌ها را در نتایج بر اساس زمانی که مکان برای بازدیدکنندگان باز است فیلتر کنید

      توجه داشته باشید که Google ممکن است نتایجی را نیز ارائه دهد که با این فیلتر مطابقت ندارند

      مقادیر ممکن: "open_now"، "24_hours"، "$day_value"، "$day_value;$time_value"؛

      به‌جای $day_value از یکی از این مقادیر استفاده کنید: "monday"، "tuesday"، "wednesday"، "thursday"، "friday"، "saturday"، "sunday"؛

      به‌جای $time_value از یکی از این مقادیر استفاده کنید: "00"، "01"، "02"، "03"، "04"، "05"، "06"، "07"، "08"، "09"، "10"، "11"، "12"، "13"، "14"، "15"، "16"، "17"، "18"، "19"، "20"، "21"، "22"، "23"

      مثال: "tuesday;18"

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

      آرایه‌ای از وظایف

      • نوع: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedTaskInfo
        • 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 است.
            انواع آیتم ممکن:
            local_pack

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

            آیتم‌های داخل عنصر

            • نوع: object | null · Response36Afe1097B20_LocalPackSerpElementItem
                • نوع: object · Response36Afe1097B20_LocalPackSerpElementItem
                  • type
                    تمایزدهنده
                    نوع: string | null

                    نوع عنصر

                  • booking_url
                    نوع: string | null

                    نشانی URL صفحه رزرو

                  • cid
                    نوع: string | null

                    شناسه مشتری تعیین‌شده توسط Google

                  • description
                    نوع: string | null

                    توضیح پیوند

                  • domain
                    نوع: string | null

                    دامنه وب‌سایتی که ویدیو را میزبانی می‌کند

                  • is_paid
                    نوع: boolean | null

                    نشان می‌دهد آیا عنصر یک تبلیغ است

                  • page
                    نوع: integer | null

                    شماره صفحه نتایج جستجو
                    شماره صفحه SERP را نشان می‌دهد که عنصر در آن قرار دارد

                  • phone
                    نوع: string | null

                    شماره تلفن

                  • position
                    نوع: string | null

                    تراز عنصر در SERP
                    می‌تواند مقادیر زیر را داشته باشد:
                    left، right

                  • rank_absolute
                    نوع: integer | null

                    رتبه مطلق در SERP
                    موقعیت مطلق در میان همه عناصر موجود در SERP
                    همیشه مقدار 0 را برای desktop دارد

                  • rank_group
                    نوع: integer | null

                    رتبه گروه در SERP
                    موقعیت در یک گروه از عناصر با مقادیر type یکسان؛
                    موقعیت عناصر با مقادیر type متفاوت از rank_group حذف می‌شود؛
                    همیشه مقدار 0 را برای desktop دارد

                  • rating
                    نوع: object | null · Response36Afe1097B20_RatingInfo

                    امتیاز عنصر
                    نرخ محبوبیت بر اساس نظرات که در SERP نمایش داده می‌شود؛
                    اگر وجود نداشته باشد، برابر null است

                    • rating_max
                      نوع: integer | null

                      حداکثر مقدار یک rating_type

                    • rating_type
                      نوع: string | null

                      نوع امتیاز اینجا می‌توانید عناصر زیر را بیابید: Max5، Percents، CustomMax

                    • value
                      نوع: number | null قالب: double

                      مقدار امتیاز

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

                      میزان بازخورد

                  • 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 گوشه بالا سمت چپ قطعه نتیجه، که گوشه بالا سمت چپ صفحه نقطه مبدأ است

                  • title
                    نوع: string | null

                    عنوان سطر

                  • url
                    نوع: string | null

                    نشانی URL منبع نظر شخص ثالث

                  • xpath
                    نوع: string | null

                    XPath عنصر

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

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

          • keyword
            نوع: string | null

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

          • language_code
            نوع: string | null

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

          • location_code
            نوع: integer | null

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

          • 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/local_finder/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "local nail services",
    "min_rating": 4.5,
    "time_filter": "monday"
  }
]'

{
  "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,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملیات موفق

Live Google Local Finder SERP