[ search · extract ]● 2 cr/url · 30 req/min

استخراج محتوى الروابط

مرّر رابطًا واحدًا أو أكثر، واحصل على محتوى نظيف قابل للقراءة بعد إزالة عناصر التنقّل والإعلانات. يندمج في أنابيب RAG، وسير عمل الزحف والتلخيص لدى الوكلاء، ومهام مراقبة المحتوى.

2 credits / URL30 req / minmax 25 URLs / callPOST /api/extract

جرّب الاستخراج مباشرةً

رابط واحد في كل سطر. أدخِل مفتاح API الخاص بك واضغط للاستخراج.

auth · x-api-key

لا تملك مفتاح API؟

سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.

2 URLs · 4 credits total

[ 02 · integrate ]

دليل التكامل

انسخ المقتطف، استبدل مفتاح API الخاص بك، ثم شغّله. يعمل مع أي عميل HTTP — أمثلة أدناه بـ cURL وJavaScript وPython.

spec
POST/api/extract
base
https://www.apipick.com

Extract clean readable content from one or more URLs. Removes navigation, ads, and boilerplate. Returns markdown-flavoured text ready for LLM ingestion.

المعاملات
urlsarray<string>مطلوب

1–25 http(s) URLs

extract_effortstringاختياري

auto | low | high

response_lengthstringاختياري

short | medium | long

curl -X POST "https://www.apipick.com/api/extract" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "urls": [
    "https://en.wikipedia.org/wiki/Retrieval-augmented_generation",
    "https://docs.anthropic.com/claude/docs/intro-to-claude"
  ],
  "extract_effort": "auto"
}'
● 200 · الاستجابة
{
  "results": [
    {
      "url": "https://en.wikipedia.org/wiki/Retrieval-augmented_generation",
      "title": "Retrieval-augmented generation - Wikipedia",
      "content": "Retrieval-augmented generation (RAG) is a technique…",
      "status": "ok"
    }
  ],
  "result_count": 1,
  "credits_used": 2,
  "remaining_credits": 98
}
[ 03 · limits ]

حدود المعدل

يُطبَّق التقييد لكل مفتاح API، بنافذة منزلقة مدتها 60 ثانية. عند بلوغ الحد تحصل على رمز 429 نظيف مع ترويسة Retry-After.

معدل الطلبات

30req/min

لكل مفتاح API ولكل نقطة نهاية. نافذة منزلقة مدتها 60 ثانية.

التزامن

3concurrent

الحد الأقصى للطلبات الجارية المتزامنة لكل مفتاح API.

ترويسات الاستجابة
X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقة
X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية
X-RateLimit-Resetعدد الثواني حتى إعادة ضبط النافذة الحالية
Retry-Afterعدد الثواني التي يجب انتظارها قبل إعادة المحاولة (عند 429 فقط)
● 429 · طلبات كثيرة جدًا
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

الأسئلة الشائعة

كيف تُحتسب الأرصدة؟

رصيدان لكل رابط مُرسَل. استدعاء واحد بـ 5 روابط يكلّف 10 أرصدة. الحد الأقصى 25 رابطًا لكل استدعاء.

كيف تبدو الاستجابة؟

مصفوفة من كائنات { url, title, content, status }. الحقل content نص نظيف قابل للقراءة (بنمط Markdown)، بعد إزالة القوالب الجاهزة. مناسب للاستهلاك المباشر من قِبل LLM.

هل يمكنني التحكم في عمق الاستخراج؟

مرّر extract_effort (auto أو low أو high). القيمة 'auto' هي الافتراضية وتعمل مع معظم الصفحات. أما 'high' فأبطأ لكنها تؤدي عملاً أكثر شمولاً على الصفحات الثقيلة بـ JavaScript أو ذات نمط الجدار المدفوع.

ماذا يحدث إذا فشل أحد الروابط؟

الروابط الفاشلة تُعيد قيمة status برمز خطأ في مصفوفة النتائج، لكن الاستدعاء ككل ينجح. تُحتسب الأرصدة عن جميع الروابط المُرسَلة بغضّ النظر عن نتيجة كل رابط على حدة.

هل يوجد مخطط أداة؟

‏GET /api/extract/tool-schema يُعيد تعريفات OpenAI function وtool use في Claude.