Firecrawl
Search, scrape, map, file parsing and asynchronous crawling.
إرسال مهمة زحف غير متزامنة.
أرسل زحف موقع ويب غير متزامن. وفّر url وlimit؛ واختياريًا خيارات الزحف والكشط الموثّقة. الحقل Idempotency-Key مطلوب. يعيد HTTP 202 مهمة؛ استخدم id الخاص بها مع نقطة نهاية الاستطلاع المقابلة في Felo حتى تصبح completed أو failed أو cancelled. حقول تسعير المهمة هي تفويض المزوّد وبيانات التسوية الوصفية، وليست سجلات فوترة Felo.
مرجع التسعير
- القياس: مرجع النتائج المقيسة.
- تقدير الطلب المرجعي: غير متاح.
- سعر وحدة العميل المرجعي: 0.005 دولار أمريكي.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringIdempotency
- Key مطلوبيجب أن يكون طول UTF-8 بعد التشذيب من 1 إلى 191 بايت.
- النوع: integerlimitالحد الأدنى:1الحد الأقصى:1000مطلوب
Integer numbers.
- النوع: stringurlمطلوب
عنوان URL من نوع HTTPS باسم مضيف، بلا بيانات اعتماد أو جزء مرساة. لا يُدعم الإدخال المشذّب المنتهي بـ .pdf (غير حساس لحالة الأحرف).
- النوع: boolean | nullallow
External Links - النوع: boolean | nullallow
Subdomains - النوع: boolean | nullcrawl
Entire Domain - النوع: number | nulldelayالحد الأدنى:0الحد الأقصى:30
- النوع: array string[] | null …20exclude
Paths - النوع: boolean | nullignore
Query Parameters - النوع: array string[] | null …20include
Paths - النوع: integer | nullmax
Concurrency الحد الأدنى:1الحد الأقصى:20Integer numbers.
- النوع: integer | nullmax
Discovery Depth الحد الأدنى:0الحد الأقصى:10Integer numbers.
- النوع: object | nullscrape
Options - excludeالنوع: array string[] | null …50
Tags - includeالنوع: array string[] | null …50
Tags - maxالنوع: integer | null
Age الحد الأدنى:0الحد الأقصى:31536000000Integer numbers.
- minالنوع: integer | null
Age الحد الأدنى:0الحد الأقصى:31536000000Integer numbers.
- onlyالنوع: boolean | null
Main Content - timeoutالنوع: integer | nullالحد الأدنى:1000الحد الأقصى:300000
Integer numbers.
- النوع: string | null تعدادsitemapالقيم
- null
- skip
- include
- only
- النوع: object202
نجاح
- النوع: string | null التنسيق: date-timecompleted
At مطلوبthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- النوع: string | null التنسيق: date-timecreated
At مطلوبthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- النوع: string | nullendpointمطلوب
معرّف عملية المزوّد؛ استخدم مسار وظيفة Felo الموثّق للاستعلام الدوري.
- النوع: object | nullerrorمطلوب
- codeالنوع: string | null
- messageالنوع: string | null
- النوع: string | nullidمطلوب
- objectثابت:integration_async_jobمطلوب
- outputمطلوب
- النوع: object | nullpricingمطلوب
بيانات وصفية لتفويض المزوّد وتسويته بالميكرو دولار؛ وليست رصيد Felo أو حجزًا أو إيصال فوترة من Felo.
- authorizedالنوع: integer | null
Micros U S D Integer numbers.
- billingالنوع: string | null
Mode - currencyالنوع: string | null
- finalالنوع: integer | null
Micros U S D Integer numbers.
- النوع: string تعدادstatusمطلوبالقيم
- queued
- running
- completed
- failed
- cancelled
- النوع: boolean | nulloutput
Expired
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
فشلت العملية. احتفظ بمعرّف طلب الاستجابة عند التواصل مع دعم Felo.
curl https://openapi.felo.ai/v1/beta/firecrawl/crawl \
--request POST \
--header 'Idempotency-Key: ' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"url": "https://example.com",
"limit": 1
}'
{
"completedAt": null,
"createdAt": null,
"endpoint": null,
"error": {
"code": null,
"message": null
},
"id": null,
"object": "integration_async_job",
"output": null,
"outputExpired": null,
"pricing": {
"authorizedMicrosUSD": null,
"billingMode": null,
"currency": null,
"finalMicrosUSD": null
},
"status": "queued"
}