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

استخراج محتويات الصفحات الكاملة لمجموعة من عناوين URL.

الخادم:https://openapi.felo.ai
مكتبات العملاء

Exa

​

Semantic search, page content, cited answers and asynchronous research.

Exa العمليات

استخراج محتويات الصفحات الكاملة لمجموعة من عناوين URL.

​

اجلب نص الصفحة وبياناتها الوصفية لعناوين URL لديك بالفعل. ids مطلوب ويأخذ قيم id من post_exa_search — وهي عناوين URL عادية، لذا يعمل أي عنوان. فعّل أو عطّل text وhighlights وsummary وsubpages وlivecrawl. يعيد results[] مع id وtitle وurl وauthor وtext، إضافةً إلى مصفوفة statuses[] تعطي status وsource لكل عنوان URL — اقرأها، لأن عنوان URL تعذّر جلبه يُبلَّغ عنه هناك بدلًا من رفع استثناء. تُقدَّم النتائج المخزّنة مؤقتًا فورًا؛ وعند غيابها يُستخدم زحف مباشر. لموقع كامل بدلًا من قائمة عناوين، post_firecrawl_crawl.

مرجع التسعير

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

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

الجسم
مطلوب
application/json
  • ids
    النوع: array string[]
    مطلوب

    عناوين URL (أو معرّفات نتائج Exa) المراد جلب المحتوى لها.

  • highlights
    النوع: boolean

    إرجاع مقتطفات ذات صلة ومميّزة.

  • livecrawl
    النوع: string تعداد

    سياسة الحداثة: الزحف الحي دائمًا، أو الرجوع إلى الزحف الحي عند فقدان ذاكرة التخزين المؤقت، أو عدم الزحف الحي أبدًا.

    القيم
    • always
    • fallback
    • never
  • stream
    النوع: boolean تعداد
    ثابت:  
    false
    القيم
    • false
  • subpages
    النوع: integer

    عدد الصفحات الفرعية المرتبطة المراد جلبها أيضًا.

  • summary
    النوع: boolean

    إرجاع ملخّص للصفحة مولّد بالذكاء الاصطناعي.

  • text
    النوع: boolean

    إرجاع النص الكامل للصفحة.

الاستجابات
  • 200
    النوع: object

    تم جلب المحتويات بنجاح.

    • requestId
      النوع: string
    • results
      النوع: array object[]
      • author
        النوع: string
      • highlights
        النوع: array string[]
      • id
        النوع: string
      • publishedDate
        النوع: string
      • summary
        النوع: string
      • text
        النوع: string
      • title
        النوع: string
      • url
        النوع: string
    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/exa/contents
curl https://openapi.felo.ai/v1/beta/exa/contents \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "ids": [
    "https://example.com/article"
  ],
  "text": true,
  "highlights": true,
  "summary": true,
  "subpages": 1,
  "livecrawl": "always",
  "stream": false
}'
{
  "requestId": "string",
  "results": [
    {
      "title": "string",
      "url": "string",
      "publishedDate": "string",
      "author": "string",
      "id": "string",
      "text": "string",
      "highlights": [
        "string"
      ],
      "summary": "string"
    }
  ]
}
Extract full page contents for a set of URLs.