POST AI agent ready /v1/url/parse

URL Parse API - مستخرج مكون URL مجاني

يقسم عنوان URL إلى مكوناته الهيكلية: البروتوكول، واسم المضيف، والمنفذ، واسم المسار، ومعلمات البحث (كأزواج قيمة المفتاح)، وجزء التجزئة. مفيد لتحليل URL ومنطق التوجيه.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/url/parse \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/path?q=test&page=2#section"}'

When to use this API

التوجيه المستند إلى عنوان URL في وظائف بدون خادم

تحليل عناوين URL للطلبات الواردة لاستخراج مقاطع المسار ومعلمات الاستعلام لتوجيه الطلب بدون إطار عمل كامل.

تحليل الروابط وتصنيفها

قم باستخراج اسم المضيف من عناوين URL المقدمة من المستخدم لتصنيف الروابط حسب المجال، أو اكتشاف عناوين URL التابعة، أو حظر أصول محددة.

استخراج علامة التحليلات

تحليل عناوين URL التسويقية لاستخراج معلمات UTM (utm_source، utm_medium، utm_campaign) لتتبع الإسناد.

Frequently asked questions

هل يتم إرجاع معلمات الاستعلام ككائن؟

نعم. يحتوي حقل searchParams على كائن قيمة المفتاح حيث تكون كل معلمة استعلام عبارة عن إدخال منفصل.

ماذا يحدث مع مفاتيح معلمات الاستعلام المكررة؟

يتم إرجاع المفاتيح المكررة كمصفوفة. على سبيل المثال، ?tag=a&tag=b ينتج { tag: ["a", "b"] }.

هل يتعامل مع عناوين URL النسبية؟

تتوقع واجهة برمجة التطبيقات (API) عناوين URL مطلقة مع بروتوكول. تُرجع المسارات النسبية مثل "/page?q=1" خطأً.

هل أسماء النطاقات الدولية مدعومة؟

نعم. تتعامل واجهة برمجة التطبيقات (API) مع نطاقات IDN (punycode) وتقوم بفك تشفيرها في الاستجابة.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.