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

كشط صفحة واحدة وإعادة محتواها الرئيسي بصيغة markdown.

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

Firecrawl

​

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

Firecrawl العمليات

كشط صفحة واحدة وإعادة محتواها الرئيسي بصيغة markdown.

​

اجلب عنوان URL واحدًا واحصل على محتواه الرئيسي بصيغة markdown. url وproxy كلاهما مطلوب — ويجب أن يكون proxy هو basic في الملف المقيس — وformats يحدّد الإخراج. يعيد success وdata مع markdown إضافةً إلى كائن metadata كبير يحمل وسوم og: وtwitter: للصفحة وstatusCode وsourceURL وlanguage. ⚠️ يجب أن يكون عنوان URL عبر HTTPS وألا يشير إلى PDF؛ فكلاهما يُرفض بدلًا من المحاولة بأفضل جهد. استخدمه عندما لديك العنوان وتريد النص. لعدة عناوين دفعة واحدة، يشغّلها post_firecrawl_batch_scrape كمهمة خلفية واحدة، بينما ينفّذ extractWebContent دفعة صغيرة بشكل متزامن. ولإيجاد العناوين أولًا، post_firecrawl_map.

مرجع التسعير

  • القياس: وحدات موارد الخطة.
  • تقدير الطلب المرجعي: 0.001071 دولار أمريكي.
  • أساس تكلفة الوحدة: 0.001071 دولار أمريكي.
  • وحدة المورد: firecrawl_credit.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
  • لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.

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

الجسم
مطلوب
application/json
  • proxy
    تعداد
    ثابت:  
    basic
    مطلوب
    القيم
    • basic
  • url
    النوع: string التنسيق: https_url
    مطلوب

    اللواحق غير المدعومة: .pdf.

  • formats
    النوع: array string[] 1…1تعداد
    ثابت:  
    [ "markdown" ]
    القيم
    • markdown
  • onlyCleanContent
    النوع: boolean تعداد
    ثابت:  
    false
    القيم
    • false
الاستجابات
  • 200
    النوع: object

    اكتمل الكشط بنجاح.

    • creditsUsed
      النوع: integer

      أرصدة Firecrawl التي يستهلكها الطلب (1 لكل صفحة).

    • data
      النوع: object
      • markdown
        النوع: string

        محتوى الصفحة المكتشطة بصيغة markdown.

      • metadata
        النوع: object

        بيانات وصفية للصفحة مثل العنوان والوصف وعنوان URL المصدر وحالة HTTP.

        • description
          النوع: string
        • sourceURL
          النوع: string
        • statusCode
          النوع: integer

          Integer numbers.

        • title
          النوع: string
    • 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/scrape
curl https://openapi.felo.ai/v1/beta/firecrawl/scrape \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "proxy": "basic",
  "url": "https://example.com"
}'
{
  "success": true,
  "data": {
    "markdown": "string",
    "metadata": {
      "title": "string",
      "description": "string",
      "sourceURL": "string",
      "statusCode": 1
    }
  },
  "creditsUsed": 1
}
Scrape a single page and return its main content as markdown.