Firecrawl
Search, scrape, map, file parsing and asynchronous crawling.
تشغيل بحث ويب وإعادة نتائج مرتّبة.
ابحث في الويب واحصل على نتائج مرتّبة. query مطلوب؛ ويحدّد limit العدد. يعيد success وcreditsUsed وid للطلب وdata.web[] مع url وtitle وdescription وposition — عناوين ومقتطفات فقط، دون نص الصفحة. استخدم شيئًا آخر عندما: تريد نص الصفحة في الاستدعاء نفسه — searchWeb يعيده ويجيب في ثلث الوقت؛ تعرف عناوين URL بالفعل — post_firecrawl_scrape؛ تريد صلة يحكم عليها المعنى لا الكلمات المفتاحية — post_exa_search.
مرجع التسعير
- القياس: عدد النتائج المقيس.
- تقدير الطلب المرجعي: 0.002142 دولار أمريكي.
- أساس تكلفة الوحدة: 0.001071 دولار أمريكي.
- وحدة المورد:
firecrawl_credit. - مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
- لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringqueryأدنى طول:1أقصى طول:2000مطلوب
- النوع: boolean تعدادenterpriseثابت:falseالقيم
- false
- النوع: integerlimitالحد الأدنى:1الحد الأقصى:100
Integer numbers.
- النوع: array string[] 1…1تعدادsourcesثابت:[ "web" ]القيم
- web
- النوع: object200
تم البحث بنجاح.
- النوع: integercredits
Used أرصدة Firecrawl المستهلكة (نحو 2 لكل 10 نتائج).
- النوع: objectdata
- webالنوع: array object[]
نتائج بحث ويب مرتّبة.
- descriptionالنوع: string
مقتطف النتيجة.
- titleالنوع: string
عنوان النتيجة.
- urlالنوع: string
عنوان URL النتيجة.
- النوع: booleansuccess
true عند نجاح البحث.
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
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
}