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

تنظیم وظایف Google Search By Image 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 Search By Image SERP

​

صفحه‌هایی را که Google برای نشانی URL یک تصویر پیدا می‌کند در صف قرار می‌دهد و id وظیفه را در tasks[0].id برمی‌گرداند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. همتای زنده بلافاصله پاسخ می‌دهد و برای یک پرس‌وجوی واحد ساده‌تر است؛ وقتی دسته از یک فراخوانی ابزار فراتر می‌رود از صف استفاده کنید.

مرجع قیمت‌گذاری

  • اندازه‌گیری: هزینه گزارش‌شده پاسخ.
  • برآورد درخواست مرجع: 0.02 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

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

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

      ارتفاع صفحه نمایش مرورگر

      فیلد اختیاری

      می‌توانید ارتفاع صفحه نمایش مرورگر را برای محاسبه رتبه‌بندی پیکسلی یک دستگاه خاص سفارشی کنید؛

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

      نکته: برای استفاده از این پارامتر، calculate_rectangles را روی true تنظیم کنید

    • browser_screen_resolution_ratio
      نوع: integer | null

      ضریب مقیاس صفحه نمایش مرورگر

      فیلد اختیاری

      می‌توانید ضریب مقیاس صفحه نمایش مرورگر را برای محاسبه رتبه‌بندی پیکسلی یک دستگاه خاص سفارشی کنید؛

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

      نکته: برای استفاده از این پارامتر، calculate_rectangles را روی true تنظیم کنید

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

      عرض صفحه نمایش مرورگر

      فیلد اختیاری

      می‌توانید عرض صفحه نمایش مرورگر را برای محاسبه رتبه‌بندی پیکسلی یک دستگاه خاص سفارشی کنید؛

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

      نکته: برای استفاده از این پارامتر، calculate_rectangles را روی true تنظیم کنید

    • calculate_rectangles
      نوع: boolean | null

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

      فیلد اختیاری

      رتبه‌بندی پیکسلی به فاصله بین قطعه نتیجه و گوشه بالا سمت چپ صفحه اشاره دارد؛

      برای اطلاعات بیشتر به مرکز راهنمایی مراجعه کنید>>

      به‌طور پیش‌فرض، این پارامتر روی false تنظیم شده است

      نکته: اگر روی true تنظیم شود، هزینه هر وظیفه در 2 ضرب می‌شود

    • image_url
      نوع: string

      نشانی URL تصویر

      فیلد الزامی

      نتایج بر اساس تصویری که در این فیلد تعیین کرده‌اید خواهد بود

      مثال:

      https://upload.wikimedia.org/wikipedia/commons/e/ed/Elon_Musk_Royal_Society.jpg

    • 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,radius" تعیین شود

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

      حداقل مقدار برای "radius": 199.9 (میلی‌متر)

      حداکثر مقدار برای "radius": 199999 (میلی‌متر)

      مثال:

      53.476225,-2.243572,200

    • 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

    • max_crawl_pages
      نوع: integer | null

      حد خزش صفحات

      فیلد اختیاری

      تعداد صفحات نتایج جستجو برای خزش

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

      نکته: پارامترهای max_crawl_pages و depth مکمل یکدیگرند؛

      در مرکز راهنمایی ما بیشتر بدانید

    • pingback_url
      نوع: string | null

      نشانی URL اطلاع‌رسانی تکمیل وظیفه

      فیلد اختیاری

      وقتی وظیفه تکمیل شد، با ارسال درخواست GET به نشانی URL که تعیین کرده‌اید به شما اطلاع می‌دهیم

      می‌توانید رشته ‘$id’ را به‌عنوان متغیر $id و ‘$tag’ را به‌عنوان متغیر $tag کدگذاری‌شده با urlencoded استفاده کنید. مقادیر لازم را پیش از ارسال درخواست تنظیم می‌کنیم.

      مثال:

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      نکته: کاراکترهای خاص در pingback_url با urlencoded کدگذاری می‌شوند؛

      از جمله کاراکتر # به %23 کدگذاری می‌شود


      در مرکز راهنمایی ما بیشتر بدانید

    • postback_data
      نوع: string

      نوع داده postback_url

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

      با نوع داده‌ای مطابقت دارد که به سرور شما ارسال می‌شود

      مقادیر ممکن:

      advanced، html

    • postback_url
      نوع: string | null

      نشانی URL برای ارسال نتایج وظیفه

      فیلد اختیاری

      وقتی وظیفه تکمیل شد، درخواست POST با نتایج فشرده‌شده در قالب gzip را به postback_url که تعیین کرده‌اید می‌فرستیم

      می‌توانید رشته ‘$id’ را به‌عنوان متغیر $id و ‘$tag’ را به‌عنوان متغیر $tag کدگذاری‌شده با urlencoded استفاده کنید. مقادیر لازم را پیش از ارسال درخواست تنظیم می‌کنیم.

      مثال:

      http://your-server.com/postbackscript?id=$id

      http://your-server.com/postbackscript?id=$id&tag=$tag

      توجه: کاراکترهای خاص در postback_url با urlencoded کدگذاری می‌شوند؛

      از جمله کاراکتر # به %23 کدگذاری می‌شود


      در مرکز راهنمایی ما بیشتر بدانید

    • priority
      نوع: integer | null

      اولویت وظیفه

      فیلد اختیاری

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

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

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


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

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

    • se_domain
      نوع: string | null

      دامنه موتور جستجو

      فیلد اختیاری

      دامنه مرتبط موتور جستجو را بر اساس موقعیت و زبانی که مشخص می‌کنید به‌صورت خودکار انتخاب می‌کنیم

      با این حال، می‌توانید در این فیلد دامنه موتور جستجوی سفارشی تنظیم کنید

      مثال:

      google.co.uk، google.com.au، google.de و غیره.

    • search_param
      نوع: string | null

      پارامترهای اضافی پرس‌وجوی جستجو

      فیلد اختیاری

      فهرست پارامترهای موجود و جزئیات بیشتر را اینجا دریافت کنید

    • tag
      نوع: string | null

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

      فیلد اختیاری

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

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

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

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

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

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

        • data
          نوع: object | null

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

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

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

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

          مسیر URL

        • result
          نوع: object | null

          آرایه‌ای از نتایج
          در این حالت، مقدار 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/search_by_image/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/search_by_image/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "image_url": "https://dataforseo.com/wp-content/uploads/2016/11/data_for_seo_light_429.png"
  }
]'

{
  "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": null
    }
  ]
}

عملیات موفق

Setting Google Search By Image SERP Tasks