Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

صيغة HTML لواجهة كشط ChatGPT LLM المباشرة

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

DataForSEO

​

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

DataForSEO العمليات

صيغة HTML لواجهة كشط ChatGPT LLM المباشرة

​

الإجابة نفسها من ChatGPT التي يعيدها post_dataforseo_ai_chat_gpt_llm_scraper_live، لكن بصيغة HTML خام بدلًا من محلّلة. يفتح expand_citations قائمة المصادر. مغلّفة في ظرف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — الطلب المرفوض يعيد HTTP 200 مع ذلك. ⚠️ أكبر من الشكل المحلّل البالغ 11.3 KB وأصعب على الوكيل — استخدمه فقط عندما تحتاج ترميزًا أسقطه المحلّل.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.701 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. يجب عدم تطبيق مضاعفات المرجع مرة أخرى على مبالغ العملاء المسوّاة.

بيانات مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
application/json
  • النوع: array (object | null)[]
    • expand_citations
      النوع: boolean | null

      إرجاع شريط الاقتباسات الموسّع في نتائج HTML
      حقل اختياري
      لتفعيل هذا المعامل، يجب تفعيل force_web_search أيضًا;
      عند التفعيل، تُرجع نقطة النهاية بيانات HTML من شريط الاقتباسات الموسّع;
      القيمة الافتراضية: false

    • force_web_search
      النوع: boolean | null

      إجبار وكيل الذكاء الاصطناعي على استخدام البحث على الويب
      حقل اختياري
      عند التفعيل، يُلزَم نموذج الذكاء الاصطناعي بالوصول إلى معلومات الويب الحالية والاستشهاد بها;
      القيمة الافتراضية: false;
      ملاحظة: حتى إذا ضُبط المعامل على true، فلا ضمان للاستشهاد بمصادر الويب في الاستجابة

    • keyword
      النوع: string

      keyword
      حقل مطلوب
      يمكنك تحديد حتى 2000 حرف في حقل keyword
      ستُفكّ جميع ترميزات %## (كما سيُفكّ الحرف ‘+’ إلى مسافة)
      إذا احتجت إلى استخدام الحرف “%” في keyword، فحدده بالشكل “%25”;
      وإذا احتجت إلى استخدام الحرف “+” في keyword، فحدده بالشكل “%2B”

      تعرّف على قواعد وقيود حقلَي keyword وkeywords في واجهات DataForSEO API في مقال مركز المساعدة

    • language_code
      النوع: string

      رمز لغة محرك البحث
      حقل مطلوب إذا لم تحدد language_name
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name
      يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/languages
      مثال:en

    • language_name
      النوع: string

      الاسم الكامل للغة محرك البحث
      حقل مطلوب إذا لم تحدد language_code
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code
      يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/languages
      مثال:
      English

    • location_code
      النوع: integer

      رمز موقع محرك البحث
      حقل مطلوب إذا لم تحدد location_name
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name
      يمكنك الحصول على قائمة مواقع محركات البحث المتاحة مع location_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/{{low_se_type}}/locations
      مثال:
      2840

    • location_name
      النوع: string

      الاسم الكامل لموقع محرك البحث
      حقل مطلوب إذا لم تحدد location_code
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_code
      يمكنك الحصول على قائمة مواقع محرك البحث المتاحة مع location_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/{{low_se_name}}/locations
      مثال:
      United States

    • tag
      النوع: string | null

      معرّف مهمة يحدده المستخدم
      حقل اختياري
      الحد الأقصى للأحرف هو 255
      يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
      ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveHtmlResponseInfo
    • cost
      النوع: number | null التنسيق: double

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • status_code
      النوع: integer | null

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

    • status_message
      النوع: string | null

      رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

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

      مصفوفة المهام

      • النوع: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveHtmlTaskInfo
        • 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

          مصفوفة نتائج

          • datetime
            النوع: string | null

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

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

            عناصر نتائج البحث التي تم العثور عليها

            • date
              النوع: string | null

              تاريخ ووقت فحص صفحة HTML
              بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              مثال:
              2019-11-15 12:57:46 +00:00

            • html
              النوع: string | null

              صفحة HTML

            • page
              النوع: integer | null

              الرقم التسلسلي لصفحة HTML المُعادة

          • items_count
            النوع: integer | null التنسيق: int64

            عدد النتائج المعادة في المصفوفة items

          • keyword
            النوع: string | null

            الكلمة المفتاحية المستلمة في مصفوفة POST
            تُعاد الكلمة المفتاحية مع فك ترميز %## (سيُفكّ ترميز المحرف '+' إلى مسافة)

          • language_code
            النوع: string | null

            رمز اللغة في مصفوفة POST

          • location_code
            النوع: integer | null

            رمز الموقع في مصفوفة POST

        • 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/ai_optimization/chat_gpt/llm_scraper/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Live ChatGPT LLM Scraper API HTML