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

اجرای جستجوی وب و برگرداندن نتایج رتبه‌بندی‌شده.

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

Firecrawl

​

Search, scrape, map, file parsing and asynchronous crawling.

Firecrawl عملیات

اجرای جستجوی وب و برگرداندن نتایج رتبه‌بندی‌شده.

​

وب را جستجو کنید و نتایج رتبه‌بندی‌شده بگیرید. query الزامی است؛ limit تعداد را تعیین می‌کند. success، creditsUsed، یک id درخواست، و data.web[] با url، title، description و position را برمی‌گرداند — فقط عنوان و بریده، بدون متن صفحه. وقتی به چیز دیگری بروید که: متن صفحه را در همان فراخوانی می‌خواهید — searchWeb آن را برمی‌گرداند و در یک‌سوم زمان پاسخ می‌دهد؛ نشانی‌ها را از قبل می‌دانید — post_firecrawl_scrape؛ می‌خواهید مرتبط بودن با معنا سنجیده شود نه کلیدواژه — post_exa_search.

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

  • اندازه‌گیری: تعداد نتایج اندازه‌گیری‌شده.
  • برآورد درخواست مرجع: 0.002142 دلار آمریکا.
  • مبنای هزینه واحد: 0.001071 دلار آمریکا.
  • واحد منبع: firecrawl_credit.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
  • مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.

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

بدنه
الزامی
application/json
  • query
    نوع: string
    حداقل طول:  
    1
    حداکثر طول:  
    2000
    الزامی
  • enterprise
    نوع: boolean فهرست مقادیر
    مقدار ثابت:  
    false
    مقادیر
    • false
  • limit
    نوع: integer
    حداقل:  
    1
    حداکثر:  
    100

    Integer numbers.

  • sources
    نوع: array string[] 1…1فهرست مقادیر
    مقدار ثابت:  
    [ "web" ]
    مقادیر
    • web
پاسخ‌ها
  • 200
    نوع: object

    جستجو با موفقیت انجام شد.

    • creditsUsed
      نوع: integer

      اعتبارهای Firecrawl مصرف‌شده (حدود 2 برای هر 10 نتیجه).

    • data
      نوع: object
      • web
        نوع: array object[]

        نتایج جستجوی وب رتبه‌بندی‌شده.

        • description
          نوع: string

          بریده نتیجه.

        • title
          نوع: string

          عنوان نتیجه.

        • url
          نوع: string

          نشانی URL نتیجه.

    • success
      نوع: boolean

      true وقتی جستجو موفق باشد.

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for post/v1/beta/firecrawl/search
curl https://openapi.felo.ai/v1/beta/firecrawl/search \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "enterprise": false,
  "limit": 10,
  "query": "nike",
  "sources": [
    "web"
  ]
}'
{
  "success": true,
  "data": {
    "web": [
      {
        "title": "string",
        "url": "string",
        "description": "string"
      }
    ]
  },
  "creditsUsed": 1
}
Run a web search and return ranked results.