API NetEase Cloud Music Музыкальные чарты
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите треки из чартов NetEase Cloud Music. У каждого трека есть позиция, исполнители, альбом, длительность и показатель популярности, а также название, число прослушиваний и время последнего обновления самого чарта. popularity_score принимает значения от 0 до 100 и не является числом прослушиваний. rank относится только к текущему снимку.
NetEase Cloud Music charts читает официальные чарты NetEase и не требует параметров. Каждая запись — один трек в чарте: его rank, название и альтернативное название, исполнители, альбом и обложка, длительность, дата выхода, пометка о ненормативном контенте и индекс популярности NetEase, а также название, ID, обложка, число прослушиваний и сохранений чарта и время его последнего обновления. Используйте эту возможность, чтобы следить за лидерами NetEase Cloud Music: для отчётов по чартам, музыкального маркетинга, поиска артистов (A&R) или выявления песен, набирающих популярность.
Чарты быстро меняются, поэтому вместе с каждой сохранённой записью сохраняйте поле snapshotted_at, которое содержит время её получения, и сравнивайте запуски по этому полю. playlist_name — название чарта, к которому относится запись, а rank — позиция в этом чарте. popularity_score — индекс популярности NetEase от 0 до 100, а не число прослушиваний; duration_ms указывается в миллисекундах.
Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra NetEase Cloud Music Музыкальные чарты (netease_music/toplist).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: netease_music и action: toplist, а параметры передайте в params.
- Обязательных параметров нет.
- Необязательные параметры:
- limit: Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: rank, track_id, track_name, track_alias, duration_ms, artists, artist_ids, album_id, album_name, album_cover_url, published_at, is_explicit; всего полей: 23, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=netease_music.
- Пример тела запроса:
{
"platform": "netease_music",
"action": "toplist",
"params": {}
}
- Цена: $0.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | netease_music | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | toplist | Идентификатор возможности, фиксированное значение. |
limit | body.params | integer (1–100) | Нет | 20 | Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "netease_music",
"action": "toplist",
"params": {}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "netease_music",
"action": "toplist",
"results": [
{
"rank": 1,
"track_id": 3425638996,
"track_name": "互删 (我走以后)",
"duration_ms": 211686,
"artists": "江辰",
"artist_ids": "12641765",
"album_id": 394443308,
"album_name": "互删 (我走以后)",
"album_cover_url": "http://p3.music.126.net/nfDVr6WopOJax11vq5brPQ==/109951173820334666.jpg",
"published_at": "2026-08-28T16:00:00+00:00",
"is_explicit": false,
"popularity_score": 100,
"track_url": "https://music.163.com/song?id=3425638996",
"playlist_id": 3779629,
"playlist_name": "飙升榜",
"playlist_type": "toplist",
"playlist_cover_url": "https://p4.music.126.net/5guhqPBTcIrrhLBotgaT6w==/109951170048511751.jpg",
"playlist_track_count": 100,
"playlist_play_count": 3218496768,
"playlist_subscribed_count": 2805127,
"playlist_updated_at": "2026-09-26T04:32:03.946000+00:00",
"snapshotted_at": "2026-09-26T09:57:26.623000+00:00",
"platform": "netease_music"
},
{
"rank": 2,
"track_id": 3433437362,
"track_name": "两难pt.2",
"duration_ms": 259956,
"artists": "加木",
"artist_ids": "49320722",
"album_id": 397217802,
"album_name": "两难pt.2",
"album_cover_url": "http://p3.music.126.net/jr4V-LHARj4EGtLeDCLB_Q==/109951173909480514.jpg",
"is_explicit": false,
"popularity_score": 100,
"track_url": "https://music.163.com/song?id=3433437362",
"playlist_id": 3779629,
"playlist_name": "飙升榜",
"playlist_type": "toplist",
"playlist_cover_url": "https://p4.music.126.net/5guhqPBTcIrrhLBotgaT6w==/109951170048511751.jpg",
"playlist_track_count": 100,
"playlist_play_count": 3218496768,
"playlist_subscribed_count": 2805127,
"playlist_updated_at": "2026-09-26T04:32:03.946000+00:00",
"snapshotted_at": "2026-09-26T09:57:26.625000+00:00",
"platform": "netease_music"
}
],
"count": 20,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
rank | Трактуется так же, как на самой платформе |
track_id | Трактуется так же, как на самой платформе |
track_name | Трактуется так же, как на самой платформе |
track_alias | Трактуется так же, как на самой платформе |
duration_ms | Трактуется так же, как на самой платформе |
artists | Трактуется так же, как на самой платформе |
artist_ids | Трактуется так же, как на самой платформе |
album_id | Трактуется так же, как на самой платформе |
album_name | Трактуется так же, как на самой платформе |
album_cover_url | Трактуется так же, как на самой платформе |
published_at | Трактуется так же, как на самой платформе |
is_explicit | Трактуется так же, как на самой платформе |
popularity_score | Трактуется так же, как на самой платформе |
track_url | Трактуется так же, как на самой платформе |
playlist_id | Трактуется так же, как на самой платформе |
playlist_name | Трактуется так же, как на самой платформе |
playlist_type | Трактуется так же, как на самой платформе |
playlist_cover_url | Трактуется так же, как на самой платформе |
playlist_track_count | Трактуется так же, как на самой платформе |
playlist_play_count | Трактуется так же, как на самой платформе |
playlist_subscribed_count | Трактуется так же, как на самой платформе |
playlist_updated_at | Трактуется так же, как на самой платформе |
snapshotted_at | Трактуется так же, как на самой платформе |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
FAQ
Можно ли выбрать, какой чарт читать?
Возможность не принимает параметров и возвращает официальные чарты в том виде, в каком их публикует NetEase; поля playlist_name и playlist_id в каждой записи показывают, к какому чарту она относится. Чтобы прочитать другой публичный список, передайте его числовой ID в возможность NetEase Cloud Music Playlist.
Насколько свежие данные чартов?
В каждой записи есть две отметки времени: snapshotted_at, момент чтения записи, и playlist_updated_at, момент последнего обновления чарта на стороне NetEase. Указывайте playlist_updated_at как дату чарта, а snapshotted_at сохраняйте, чтобы показать, когда вы сняли свою копию.
Как отследить, поднимается или опускается песня в чарте?
Считывайте чарт по расписанию и сохраняйте rank для каждого track_id вместе с snapshotted_at. Изменение позиции между двумя запусками и есть движение в чарте. Если track_id появился впервые, это новинка в чарте, а если исчез, трек выбыл из чарта.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.