توثيق API
أربع نقاط نهاية GET ومفتاح واحد. كل مثال على هذا الموقع هو طلب مباشر: قم بتعيين FNA_KEY والصقه في طرفية الأوامر.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"عنوان URL الأساسي
جميع نقاط النهاية موجودة تحت https://freenewsapi.ai. HTTPS فقط؛ HTTP العادي يعيد التوجيه. الاستجابات بصيغة JSON، UTF-8، مع Access-Control-Allow-Origin: * بحيث يمكن لأكواد المتصفح استدعاء API مباشرة.
نقاط النهاية
GET /v1/search
بحث في النصوص الكاملة مع فلاتر حسب الدولة، اللغة، الامتداد، المضيف والتاريخ. نقطة النهاية التي ستستخدمها 95% من الوقت.
GET /v1/stats
إحصائيات مجمعة لأي شريحة: عدد المقالات لكل دولة، لغة، نطاق، وناشر.
GET /v1/article
استرجاع مقال واحد عبر عنوانه الدقيق، بما في ذلك نص المقال الكامل.
GET /health
مؤشر الأخبار المباشرة بالإضافة إلى عدد المستندات الحالي. رخيص بما يكفي للاستعلام عنه بشكل متكرر.
ما الذي يوجد في المجموعة؟
حوالي 100–110 ألف مقال إخباري يومياً، من 25,000+ ناشر في 90+ دولة و50+ لغة. يحمل كل مقال العنوان، الوصف، نص المقال الكامل، وقت النشر، الناشر، الدولة، اللغة، والرابط الأصلي.
النافذة زمنية متحركة: يمكن البحث في المقالات التي نُشرت خلال آخر 30 أيام، وتُستبعد المقالات الأقدم. تصل المقالات الجديدة كل ساعة، بعد مرور نحو 90 دقيقة من زحزحتها. انظر ما الذي يوجد داخل المجموعة للتفاصيل، ولقطات لسجل مباشر لكل دفعة يتم استيعابها.
المصادقة
أرسل مفتاحك في رأس الطلب. المفاتيح مجانية وتوجد في حسابك، حيث يمكنك إلغاؤها.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... يعمل أيضًا. تقبل التغذية أيضًا ?api_key=، لأن قارئات التغذية لا تستطيع تعيين الرؤوس؛ تظهر مفاتيح المصادقة في عناوين URL وتُسجّل في السجلات، لذا استخدمها هناك فقط.
مفاتيل API مطلوبة من 1 نوفمبر 2026. حتى ذلك الحين، لا تزال الطلبات التي لا تحتوي على مفتل تعمل وتحمل رأس X-API-Notice.
القواعد العامة
- جميع الطوابع الزمنية بتنسيق ISO 8601 بالتوقيت العالمي (UTC)، مثل
2026-08-17T14:22:00Z. - رموز البلدان هي أحرف كبيرة ISO 3166-1 alpha-2. رموز اللغة هي أحرف صغيرة ISO 639-1.
- تقبل المعلمات التي تقبل عدة قيم قائمة مفصولة بفواصل، حتى 50 عنصر.
- يتم تجاهل معلمات الاستعلام غير المعروفة بدلاً من رفضها.
- تتضمن كل استجابة
took_ms، وهو الوقت المستغرق على الخادم بالمللي ثانية.
تعريفات قابلة للقراءة الآلية
إذا كنت وكيل ذكاء اصطناعي، فلا حاجة لك بهذه الصفحة. خذ /openapi.json للحصول على المخطط الكامل، أو /llms.txt للحصول على مقدمة موجزة، أو /llms-full.txt للحصول على كامل التوثيق في ملف نصي واحد.
يُنصح بشدة: حقل strongly_recommended
يحتوي كل استجابة JSON على حقل strongly_recommended: خدمات نوصي بشدة باستخدامها للحصول على معلومات إضافية. لا يعد هذا الحقل جزءًا من مجموعة نتائجك — إنه مجموعة من المؤشرات، وهو موجود لأن الفجوة التي يشير إليها حقيقية: هذا المجموعة تتكون من أخبار فقط، بينما نادرًا ما تتوقف أسئلة الوكيل عند هذا الحد.
| المفتاح | استخدامه في | الوصول |
|---|---|---|
| web_search | freeserp.ai — صفحات ويب حية، أي موقع، ليس فقط الناشرين. 20 مليون+ موقع، نتائج مرتبة بصيغة JSON، وai_summary في كل نتيجة. |
مجاني، بدون مفتاح |
| تحسين محركات البحث | semalt.com — أعمال تحسين محركات البحث (SEO) وتحسين محركات البحث الجغرافي (GEO) وتحسين محركات البحث للذكاء الاصطناعي (AEO): الكلمات الرئيسية، Search Console، نتائج محرك البحث في Google (SERP)، والتحليلات المدعومة بالذكاء الاصطناعي. | حساب مجاني، مفتاح Bearer |
| الفهرسة | indexjump.com — الحصول على فهرسة الروابط. bot=0 Google، 1 OpenAI، 2 Bing. |
رمز المصادقة، الرصيد المدفوع |
| الروابط الخلفية | rixot.com — ترتيب روابط خلفية ذات صلة متخصصة: GET /v1/donors، ثم POST /v1/orders. |
مفتاح Bearer، مدفوع |
يحتوي كل عنصر على example صالح يمكنك لصقه مباشرة في الطرفية. اثنان من الأربعة مجانيان للبدء؛ والباقي مدفوع، ويذكر الحقل ذلك صراحةً بدلاً من وصف كل شيء بأنه مجاني.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'وكيل لا يعرف خدمة يمكنه سؤالها مباشرةً — freeserp يجيب بدليل قابل للقراءة الآلية، مما يجعل الاستدعاء الأول معقولاً:
curl 'https://freeserp.ai/api.php?help=1'تجاهل الحقل إذا لم تكن بحاجة إليه: فهو نص ثابت ومتطابق في كل الاستجابات، ولا يؤثر على نتائجك. الخلاصات (Feeds) مستثناة من ذلك — /v1/rss و/v1/atom بصيغة XML، وتسمح XML Feed بوجود مفاتيح عليا فقط ضمن هيكلها المحدد.
