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

استخراج محتوای کامل صفحه برای مجموعه‌ای از نشانی‌ها.

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

Exa

​

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

استخراج محتوای کامل صفحه برای مجموعه‌ای از نشانی‌ها.

​

متن و فراداده صفحه را برای نشانی‌هایی که از قبل دارید واکشی کنید. ids الزامی است و مقادیر id را از post_exa_search می‌گیرد — که خود نشانی‌های ساده‌اند، پس هر نشانی کار می‌کند. text، highlights، summary، subpages و livecrawl را روشن یا خاموش کنید. results[] را با id، title، url، author و text، به‌همراه آرایه statuses[] که status و source را برای هر نشانی می‌دهد برمی‌گرداند — آن را بخوانید، چون نشانی‌ای که واکشی نشده همان‌جا گزارش می‌شود و استثنا ایجاد نمی‌کند. نتایج کش‌شده فوراً ارائه می‌شوند؛ در صورت نبود، خزش زنده انجام می‌شود. برای یک سایت کامل و نه فهرست نشانی، 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

    بازگرداندن خلاصه تولیدشده با AI از صفحه.

  • 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.