গাইড

Spotify প্লে কাউন্ট API: ID বা ISRC দিয়ে যেকোনো ট্র্যাকের সর্বমোট স্ট্রিম

Spotify-এর Web API কখনও বলে না একটি ট্র্যাক কতবার বাজানো হয়েছে। এর সবচেয়ে কাছের জিনিস পপুলারিটি, ০–১০০ স্কোর, যা Spotify-এর নিজের রেফারেন্স অনুযায়ী মূলত মোট প্লের ভিত্তিতে হিসাব করা, আর যাকে তারা ডিপ্রিকেটেড চিহ্নিত করেছে। এই এন্ডপয়েন্টগুলো কাউন্টটিই ফেরত দেয়: Spotify ID বা ISRC দিয়ে একটি ট্র্যাক, অথবা এক কলে সর্বোচ্চ ৫০টি ট্র্যাক।

লেখক Eduardo Airaudo, API-র মেইনটেইনার · আপডেট: ২২ অক্টোবর, ২০২৬

অফিসিয়াল ট্র্যাক অবজেক্টে যা বাদ

Spotify Web API-র GET /v1/tracks/{id} ফেরত দেয় অ্যালবাম, শিল্পী, duration_ms, explicit, external_ids, নাম, popularity এবং আরও কয়েকটি ফিল্ড। এর কোনোটিই প্লে গোনে না। পপুলারিটিই সবচেয়ে কাছের: Spotify-এর রেফারেন্স একে ০ থেকে ১০০ পর্যন্ত একটি মান বলে, যা মূলত ট্র্যাকটি কতবার বাজানো হয়েছে এবং সেগুলো কত সাম্প্রতিক তার ভিত্তিতে হিসাব করা, আর একে ডিপ্রিকেটেড চিহ্নিত করে। Spotify-এর ২০২৬ সালের ফেব্রুয়ারির পরিবর্তনে ১১ ফেব্রুয়ারি ২০২৬ থেকে তৈরি ডেভেলপমেন্ট-মোড অ্যাপের জন্য এটি সরিয়ে দেওয়া হয়েছে।

স্কোর কাউন্টের কাজ করতে পারে না। এটি আপেক্ষিক, তাই একটি অ্যালবাম বা ক্যাটালগ জুড়ে যোগ হয় না, আর সাম্প্রতিক প্লেকে বেশি গুরুত্ব দেয় — একই রেফারেন্স বলে, এখন বেশি বাজানো গান অতীতে বেশি বাজানো গানের চেয়ে বেশি স্কোর পায় — তাই একটি ট্র্যাক সব মিলিয়ে কতবার বাজানো হয়েছে তা বলতে পারে না।

স্পেকের ভাষায়, এই API-র Partner গ্রুপ হলো “Spotify's internal (pathfinder) data, including play counts”। /partner/track/count একটি ট্র্যাকের সর্বমোট কাউন্ট ফেরত দেয়, /partner/tracks/count একসাথে সর্বোচ্চ ৫০টি ট্র্যাকের, আর /partner/track সেটি পূর্ণ ট্র্যাক রেকর্ডের ভেতরে বহন করে।

যা ফেরত আসে

ফিল্ড ধরে ধরে, স্পেকের রেসপন্স স্কিমা যেভাবে সংজ্ঞায়িত করে। একক ট্র্যাকের কল কাউন্টটির নাম দেয় streams; ব্যাচ দেয় playcount।

একটি ট্র্যাক

GET /partner/track/count

streams
সর্বমোট প্লে কাউন্ট, পূর্ণসংখ্যা (int64) হিসেবে। স্পেকে nullable, আর ১,০০০ প্লের নিচের ট্র্যাকের জন্য ০।
spotify_track_id
ট্র্যাকের Spotify ID।
isrc
ট্র্যাকের ISRC। স্পেকে nullable।
result
success বা error, পাশে একটি ছোট message।

একটি ব্যাচ

GET /partner/tracks/count

tracks[]
অনুরোধ করা প্রতিটি ID-র জন্য একটি এন্ট্রি, অনুরোধের ক্রমে।
tracks[].playcount
সর্বমোট প্লে (int64, nullable); ১,০০০-এর নিচের ট্র্যাকের জন্য ০।
tracks[].status
ok, not_found বা error; এটি error হলে সাথে একটি error টেক্সট থাকে।
tracks[].name
ট্র্যাকের নাম; পাওয়া না গেলে null।
tracks[].artists[]
প্রতিটি শিল্পীর id ও name।
tracks[].releaseDate
ট্র্যাকের অ্যালবামের রিলিজের তারিখ: YYYY-MM-DD, অথবা কম নির্দিষ্ট নির্ভুলতায়।
missing[]
যে অনুরোধ করা ID-গুলোর স্ট্যাটাস ok নয়।

০ মানে ১,০০০-এর নিচে, কখনও বাজানো হয়নি এমন নয়। স্পেক বলে ১,০০০ প্লের কম ট্র্যাকের জন্য Spotify ০ জানায়, তাই ০-কে কাউন্ট হিসেবে নয়, “১,০০০-এর নিচে” হিসেবে সংরক্ষণ করুন।

রেকর্ড করা নমুনা · 2026-10-22-এ নেওয়া

GET /partner/track/count

৬ লাইন — পুরো রেকর্ড করা বডি।

রেকর্ড করা নমুনা · 2026-10-22-এ নেওয়া

GET /partner/tracks/count

১৮ লাইন — পুরো রেকর্ড করা বডি।

একটি ট্র্যাক, অথবা প্রতি কলে ৫০টি

  • GET /partner/track/countTrack play count

    Lifetime play count of one track, by Spotify id (spotify_track_id, or its alias id) or by isrc. Spotify reports 0 for tracks with fewer than 1,000 plays. Play counts are cached for 1 hour; for many tracks use /partner/tracks/count.

    প্যারামসspotify_track_id, id, isrc, cache

  • GET /partner/tracks/countTrack play counts (batch)

    Lifetime play counts for up to 50 tracks in one call. Entries come back in request order with status ok, not_found or error; ids without a play count are also listed in missing. Each id is cached for 1 hour.

    প্যারামসids, cache

  • GET /partner/trackPartner track data

    Track with its play count (data.trackUnion.playcount), album, artists and content ratings. Add slim=1 to keep only {id, uri, profile.name, visuals.avatarImage} of each artist (the full payload embeds the first artist's discography and is ~100 KB).

    প্যারামসid, slim, cache

/partner/tracks/count সর্বোচ্চ ৫০টি কমা দিয়ে আলাদা করা ID নেয় এবং যে ক্রমে পাঠিয়েছেন সেই ক্রমে উত্তর দেয়, তাই ৫০টি ট্র্যাকে একটিই রিকোয়েস্ট লাগে, ৫০টি নয়।

প্লে কাউন্ট আনুন

Spotify ID দিয়ে একটি ট্র্যাক

ID হলো যেকোনো Spotify URL-এ /track/-এর পরের ২২ অক্ষরের স্ট্রিং। ISRC দিয়ে ট্র্যাক খুঁজতে id=-এর জায়গায় isrc= পাঠান।

এক কলে সর্বোচ্চ ৫০টি ট্র্যাক

কাউন্টের আগে প্রতিটি এন্ট্রির status পড়ুন। এন্ট্রিগুলো ID-র ক্রমে ফেরত আসে; যার প্লে কাউন্ট নেই, সেটির জায়গায় not_found বা error চিহ্ন থাকে এবং সেটি আবার missing-এ তালিকাভুক্ত হয়।

কোড ছাড়া প্লে কাউন্ট

কাউন্টগুলো যদি নিজের কোডের বদলে স্প্রেডশিটের জন্য লাগে, একই মেইনটেইনারের দুটি Apify Actor সেগুলো ডেটাসেট হিসেবে ফেরত দেয়। রানের জন্য Apify অ্যাকাউন্ট লাগে, API কী লাগে না: লিংক পেস্ট করুন, JSON বা CSV ডাউনলোড করুন।

  • Spotify Play Count Scraper (নতুন ট্যাবে খোলে)eduair94/spotify-play-count-scraper

    ট্র্যাক, অ্যালবাম, শিল্পী বা প্লেলিস্টের লিংক, URI অথবা ID পেস্ট করুন; এটি প্রতি ট্র্যাকে একটি সারি ফেরত দেয় প্লে কাউন্টসহ — শিল্পীর সেরা ট্র্যাক বা পুরো ডিসকোগ্রাফি, অ্যালবাম বা প্লেলিস্টের প্রতিটি ট্র্যাক — এবং চাইলে শিল্পীর মাসিক শ্রোতার একটি সারি।

  • Spotify Scraper (নতুন ট্যাবে খোলে)eduair94/spotify-scraper

    সাধারণ Actor: ৬১টি ক্যাটাগরি, যার ৫টি প্লে কাউন্টের (track_play_count, album_play_counts, artist_play_counts, artist_discography_play_counts, playlist_play_counts), এবং isrc, যা ISRC দিয়ে ট্র্যাক খুঁজে প্লে কাউন্টসহ দেয়।

দুটোই প্রতি ফলাফলে বিল করে, -এ তালিকাভুক্ত দামে: Apify-এর ফ্রি প্ল্যানে প্রতি সারি $0.001, Gold ও তার ওপরের প্ল্যানে কমে $0.0006। কখন কী-এর চেয়ে রান ভালো, আর কখন নয়, তা জানতে দেখুন: স্ক্র্যাপার গাইড।

ইতিমধ্যে রাখা ইতিহাস: spotify-most-streamed-songs (opens in a new tab) on GitHub has daily play counts and daily streams for 1,000 of the most-streamed songs, as CSV and JSON history.

AI সহকারী (MCP) থেকে ব্যবহার করুন: Claude, Cursor বা VS Code-কে কোনো ট্র্যাকের স্ট্রিম জিজ্ঞেস করুন, আর Spotify MCP সার্ভারের get_track_play_count টুল এই API থেকে সর্বমোট প্লে কাউন্ট এনে দেয়। MCP সার্ভার সেট আপ করুন।

প্রশ্ন

Spotify Web API কি প্লে কাউন্ট ফেরত দেয়?

না। Web API রেফারেন্সের ট্র্যাক অবজেক্টে প্লে কাউন্টের কোনো ফিল্ড নেই। এর সবচেয়ে কাছের ফিল্ড পপুলারিটি ০–১০০ স্কোর, যা Spotify মূলত মোট প্লে ও সেগুলো কত সাম্প্রতিক তার ভিত্তিতে হিসাব করে; রেফারেন্স একে ডিপ্রিকেটেড চিহ্নিত করে, আর Spotify-এর ২০২৬ সালের ফেব্রুয়ারির পরিবর্তনে ১১ ফেব্রুয়ারি ২০২৬ থেকে তৈরি ডেভেলপমেন্ট-মোড অ্যাপের জন্য এটি সরানো হয়েছে।

কোনো ট্র্যাকে ০ প্লে দেখায় কেন?

কারণ এর প্লে ১,০০০-এর কম। স্পেক বলে ১,০০০ প্লের কম ট্র্যাকের জন্য Spotify ০ জানায়, তাই ০ মানে ১,০০০-এর নিচে, কখনও বাজানো হয়নি এমন নয়।

একসাথে অনেক ট্র্যাকের প্লে কাউন্ট কি পাওয়া যায়?

হ্যাঁ। GET /partner/tracks/count সর্বোচ্চ ৫০টি কমা দিয়ে আলাদা করা ট্র্যাক ID নেয় এবং অনুরোধের ক্রমে উত্তর দেয়, প্রতিটি এন্ট্রির স্ট্যাটাস ok, not_found বা error; প্লে কাউন্ট নেই এমন ID-ও missing-এ তালিকাভুক্ত হয়। ৫০টি ট্র্যাকে একটিই রিকোয়েস্ট লাগে, ৫০টি নয়।

ISRC দিয়ে কি ট্র্যাক খোঁজা যায়?

হ্যাঁ। GET /partner/track/count Spotify ID-র জায়গায় isrc নেয়, তাই ISRC দিয়ে সাজানো ক্যাটালগে আগে ID লুকআপের দরকার হয় না।

সংখ্যাটি কতটা হালনাগাদ?

প্লে কাউন্ট এক ঘণ্টার জন্য ক্যাশ থাকে, তাই কাউন্ট সাধারণত এর চেয়ে পুরোনো হয় না। STALE বা FALLBACK দিয়ে শুরু হওয়া X-Cache মানের অর্থ, লাইভ ফেচ ধীর বা ব্যর্থ হওয়ায় একটি পুরোনো কপি দেওয়া হয়েছে; X-Cache-Stale-Age সেটির বয়স সেকেন্ডে জানায়। নতুন কপি আনতে cache=false যোগ করুন। এই সাইটের রান বোতামগুলোও ডেমোর নিজস্ব ক্যাশের মধ্য দিয়ে যায়, তাই সেখানে সংখ্যা আরও পুরোনো হতে পারে।

কোড না লিখে কি প্লে কাউন্ট পাওয়া যায়?

হ্যাঁ, Apify-তে: রানের জন্য Apify অ্যাকাউন্ট লাগে, API কী লাগে না। Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) ট্র্যাক, অ্যালবাম, শিল্পী বা প্লেলিস্টের লিংক নেয় এবং প্রতি ট্র্যাকে প্লে কাউন্টসহ একটি সারি ফেরত দেয়; Spotify Scraper (eduair94/spotify-scraper)-এর ৬১টি ক্যাটাগরির মধ্যে ৫টি প্লে কাউন্টের। দুটোই প্রতি ফলাফলে বিল করে।

আমার কোন প্ল্যান লাগবে?

যেকোনোটি। দুটো প্লে কাউন্ট এন্ডপয়েন্টই প্রতিটি প্ল্যানে আছে, RapidAPI ও ডাইরেক্ট পোর্টাল দুই জায়গাতেই, আর প্ল্যানের তফাত মাসিক ভলিউমে। প্রতিটি RapidAPI প্ল্যানে প্রতি সেকেন্ডে ৫টি রিকোয়েস্ট চলে, আর প্রতিটি ডাইরেক্ট কী-তে ১০টি অন্তর্ভুক্ত। RapidAPI-র ফ্রি প্ল্যানে মাসে ১,০০০টি রিকোয়েস্ট চলে।

সূত্র

More guides

What changed in the API and on these pages, and when: What's new.

একটি কী নিন এবং প্রথম প্লে কাউন্ট আনুন

দুটো প্লে কাউন্ট এন্ডপয়েন্টই প্রতিটি প্ল্যানে আছে, RapidAPI ও ডাইরেক্ট পোর্টাল দুই জায়গাতেই; Apify-তে ওপরের দুটি Actor একই কাউন্ট ডেটাসেটের সারি হিসেবে দেয়, প্রতি ফলাফলে বিল হয়। RapidAPI-র ফ্রি টিয়ারে মাসে ১,০০০টি রিকোয়েস্ট: প্রতি কলে সর্বোচ্চ ৫০টি ট্র্যাক ধরলে ৫০,০০০টি পর্যন্ত প্লে কাউন্ট।

RapidAPI Apify ডাইরেক্ট পোর্টাল

কিনতে প্রস্তুত নন? ফ্রি ট্রায়াল কী নিন: ৭ দিনে ৫০০টি রিকোয়েস্ট, কার্ড ছাড়াই।