Spotify
الفنانون والأغاني والألبومات وقوائم التشغيل والبودكاست والبحث.
تبحث عن فكرة لما تبنيه؟ اطّلع على نظرة عامة على Spotify API مع صفحات نقاط النهاية وأمثلة عملية.
تبحث عن واجهة API للبحث في Spotify؟ تبحث /v1/spotify/search في الفنانين والمقاطع والألبومات وقوائم التشغيل. معرّف Spotify هو الرمز المكوّن من 22 حرفًا في نهاية رابط open.spotify.com.
- نقاط النهاية
- 9
- السعر الأساسي
- 1 رصيد
- المصدر
- مزوّد بيانات (وواجهة API الرسمية بعد الموافقة)
| نقطة النهاية | نوع الإرجاع | الرصيد |
|---|---|---|
| GET /v1/spotify/profile | Profile | 1 |
| GET /v1/spotify/posts | Post[] | 1 |
| GET /v1/spotify/post | Post | 1 |
| GET /v1/spotify/search | SearchResult[] | 1 |
| GET /v1/spotify/collection | Collection | 1 |
| GET /v1/spotify/collection/posts | Post[] | 1 |
| GET /v1/spotify/collection/tracks | Track[] | 1 |
| GET /v1/spotify/track | Track | 1 |
| GET /v1/spotify/tracks | Track[] | 1 |
الأساسية
الملف الشخصي
رصيد واحدملف شخصي عام حسب اسم المستخدم.
| handle | مطلوب | معرّف فنان Spotify (22 حرفًا). |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/spotify/profile \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02"المنشورات
رصيد واحدأحدث منشورات ملف شخصي.
| handle | مطلوب | معرّف فنان Spotify (22 حرفًا). |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/spotify/posts \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02"المنشور
رصيد واحدمنشور واحد حسب معرّفه.
| id | مطلوب | معرّف ألبوم Spotify (22 حرفًا). |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/spotify/post \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"البحث
رصيد واحدالبحث داخل منصة واحدة.
| q | مطلوب | عبارة البحث. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/spotify/search \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "q=lofi"النصوص المفرّغة والوسائط
المجموعة
رصيد واحدقائمة تشغيل أو ألبوم أو بودكاست واحد.
| id | مطلوب | معرّف قائمة التشغيل أو الألبوم أو البودكاست، أو رابطه. |
curl -G https://api.crawlfeed.dev/v1/spotify/collection \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"منشورات المجموعة
رصيد واحدالمنشورات في قائمة تشغيل أو لوحة أو قصة مميزة أو بودكاست.
| id | مطلوب | معرّف قائمة التشغيل أو اللوحة أو القصة المميزة أو البودكاست، أو رابطه. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/spotify/collection/posts \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"الموسيقى والصوت
مقاطع المجموعة
رصيد واحدالمقاطع الصوتية في قائمة تشغيل أو ألبوم.
| id | مطلوب | معرّف قائمة التشغيل أو الألبوم، أو رابطه. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/spotify/collection/tracks \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"المقطع الصوتي
رصيد واحدمقطع صوتي واحد: أغنية أو صوت.
| id | مطلوب | معرّف المقطع الصوتي أو الصوت، أو رابطه. |
curl -G https://api.crawlfeed.dev/v1/spotify/track \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"المقاطع الصوتية
رصيد واحدالمقاطع الصوتية لفنان.
| handle | مطلوب | اسم مستخدم الفنان أو معرّفه أو رابطه. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/spotify/tracks \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02"أدلة
تقبل كل نقطة نهاية أيضًا fresh=true (لتجاوز التخزين المؤقت بضعف السعر) وinclude_raw=true (لإضافة بيانات المنصة الأصلية). راجع شكل الاستجابة والرصيد.