API de NetEase Cloud Music
Consulta listas, playlists y comentarios de canciones en NetEase Cloud Music. playlist_id y song_id identifican colecciones y pistas diferentes.
La posición de una canción pertenece a la lista observada y no forma un historial. Comentarios populares, respuestas y likes no representan reproducciones ni preferencia de todos los oyentes.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de NetEase Cloud Music, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Consultar una lista musical destacadatoplist | Obtiene una lista pública de NetEase Cloud Music sin parámetros de negocio, con posición, canción, artistas y álbum. | $0.56 por 1.000 solicitudes | Normal |
Leer las pistas de una playlistplaylist | Consulta mediante playlist_id las canciones de una playlist y conserva su orden, duración, artistas y álbum. | $0.56 por 1.000 solicitudes | Normal |
Leer comentarios de una cancióncomments | Lee comentarios de la canción identificada por song_id, con orden opcional. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de NetEase Cloud Music?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
toplistConsultar una lista musical destacada Obtiene una lista pública de NetEase Cloud Music sin parámetros de negocio, con posición, canción, artistas y álbum. | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | 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 | |
playlistLeer las pistas de una playlist Consulta mediante | playlist_id | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | 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 |
commentsLeer comentarios de una canción Lee comentarios de la canción identificada por | song_id | sort | Entrega síncrona | — | $0.56 por 1.000 solicitudes | id · song_id · song_name · url · text · like_count · reply_count · is_hot · is_reply · parent_comment_id · author_name · author_avatar_url · posted_at · platform |
¿Qué significan los parámetros de NetEase Cloud Music toplist?
Obtiene una lista pública de NetEase Cloud Music sin parámetros de negocio, con posición, canción, artistas y álbum. rank refleja esa lista observada y no el rendimiento histórico de la pista.
Esta acción no tiene parámetros de negocio. Envía únicamente los identificadores de plataforma y acción.
¿Qué significan los parámetros de NetEase Cloud Music playlist?
Consulta mediante playlist_id las canciones de una playlist y conserva su orden, duración, artistas y álbum. No modifica la lista ni garantiza que las pistas sigan reproducibles en toda región.
playlist_idObligatorio- Para
playlist, es el ID numérico de una lista de reproducción de NetEase Cloud Music. También puedes enviar un enlace a la lista que contengaplaylist?id=o/playlist/ID. No es un ID de canción. La accióntoplistobtiene las listas oficiales y no requiere este campo.NetEase Cloud Music: lista y canción son objetos distintos — La página oficial de listas separa el contenedor de la lista de cada canción enlazada. `playlist_id` localiza la lista y `song_id` la pista; la presencia en la web no garantiza cobertura completa o actualizada de todo el ranking. · Consultada
¿Qué significan los parámetros de NetEase Cloud Music comments?
Lee comentarios de la canción identificada por song_id, con orden opcional. Distingue comentario popular, respuesta y padre cuando existen; no publica ni promete el hilo completo.
song_idObligatorio- Para
comments, es el ID numérico de una canción. También puedes enviar un enlace a la canción que contengasong?id=o/song/ID. Un ID de lista de reproducción no puede sustituir a un ID de canción.NetEase Cloud Music: la consulta de comentarios debe apuntar a la canción, no a la lista de éxitos — La lista oficial de canciones destacadas enlaza a las páginas individuales de cada tema, lo que sirve para confirmar que la canción y la lista de éxitos son objetos distintos. Esta fuente no detalla el orden de los comentarios ni el alcance de las respuestas en EveryInfra, los cuales se rigen por el contrato validado anteriormente. · Consultada sortOpcional- Orden de los comentarios de la canción:
hotpor popularidad (predeterminado),recommendpor recomendación,timepor fecha.latestynewson formas compatibles de escribir el orden por fecha.newestno se reconoce y cualquier valor desconocido usahot. Los comentarios populares fijados aún pueden aparecer en los resultados.
Cómo usar la API de NetEase Cloud Music
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"netease_music","action":"toplist","params":{}}'
Preguntas sobre la API de NetEase Cloud Music
¿Cómo llamo a la API de NetEase Cloud Music?
Envía POST /api/v1/social con platform igual a netease_music, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de NetEase Cloud Music?
Devuelve JSON estructurado. Por ejemplo, el esquema de toplist incluye rank, track_id, track_name y track_alias. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de NetEase Cloud Music?
La página oficial de listas separa el contenedor de la lista de cada canción enlazada. playlist_id localiza la lista y song_id la pista; la presencia en la web no garantiza cobertura completa o actualizada de todo el ranking.
¿Qué parámetros son obligatorios?
Depende de la acción. toplist no requiere parámetros obligatorios; playlist requiere playlist_id; comments requiere song_id.
¿Las acciones de NetEase Cloud Music responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.