API de plataforma de EveryData
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 3
- Por 1.000
- 0,556 US$
Funciones disponibles
Compara las acciones de NetEase Cloud Music por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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é 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.
¿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 distintosLa 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 éxitosLa 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. Actualmente,newestno se reconoce, y un valor desconocido volverá al predeterminadohot. 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 devuelto si la acción es 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 de origen contengan 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.