API de plataforma de EveryData
API de SoundCloud
Busca pistas, artistas y playlists en SoundCloud y consulta objetos concretos por URL. La respuesta separa metadatos musicales, perfil del creador y composición de la lista.
Reproducciones, likes y reposts son señales visibles, no ingresos o audiencia histórica. La API no entrega el audio ni concede licencia sobre pistas o portadas.
- Endpoint
- POST /api/v1/social
- Funciones
- 6
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de SoundCloud 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 |
|---|---|---|---|---|---|---|
searchBuscar pistas en SoundCloud Busca pistas de SoundCloud mediante | keyword | — | 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. | $1.39 por 1.000 solicitudes | id · url · title · text · genre · tags · duration_sec · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform |
search_usersBuscar artistas y usuarios Busca cuentas por | keyword | — | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 50` 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. | $1.39 por 1.000 solicitudes | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform |
search_playlistsBuscar playlists públicas Descubre playlists mediante | keyword | — | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 50` 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. | $1.39 por 1.000 solicitudes | id · title · url · text · genre · track_count · duration_sec · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform |
trackConsultar una pista de SoundCloud Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · title · text · genre · tags · duration_sec · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform |
artistConsultar el perfil de un artista Consulta la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform |
playlistConsultar una playlist de SoundCloud Abre la | url | keyword, query | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · title · url · text · genre · track_count · duration_sec · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform |
¿Qué acepta cada acción de SoundCloud?
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 SoundCloud search?
Busca pistas de SoundCloud mediante keyword, devolviendo título, artista, género, etiquetas y duración. No reproduce el audio ni garantiza que el resultado incluya todas las subidas relacionadas.
keywordObligatorio- La acción
searchbusca pistas,search_usersbusca autores ysearch_playlistsbusca listas de reproducción. Aunque las tres usan una palabra clave, devuelven objetos diferentes. La acciónplaylistsolo usa este campo como término de búsqueda si no reconoce una URL de lista con/sets/; no equivale a obtener los detalles exactos de una lista.SoundCloud: pistas, personas y playlistsLa búsqueda de SoundCloud trata Tracks, People y Playlists como objetos distintos; una cuenta puede representar a un artista, banda u oyente. EveryInfra usa acciones separadas y no hereda todos los filtros del sitio web.Consultada
¿Qué significan los parámetros de SoundCloud search_users?
Busca cuentas por keyword y devuelve usuario, biografía, ubicación y contadores públicos. La coincidencia de nombre no verifica identidad ni disponibilidad profesional.
keywordObligatorio- La acción
searchbusca pistas,search_usersbusca autores ysearch_playlistsbusca listas de reproducción. Aunque las tres usan una palabra clave, devuelven objetos diferentes. La acciónplaylistsolo usa este campo como término de búsqueda si no reconoce una URL de lista con/sets/; no equivale a obtener los detalles exactos de una lista.SoundCloud: pistas, personas y playlistsLa búsqueda de SoundCloud trata Tracks, People y Playlists como objetos distintos; una cuenta puede representar a un artista, banda u oyente. EveryInfra usa acciones separadas y no hereda todos los filtros del sitio web.Consultada
¿Qué significan los parámetros de SoundCloud search_playlists?
Descubre playlists mediante keyword, con número de pistas, duración, género e interacciones visibles. is_album distingue la presentación publicada; no prueba una edición discográfica oficial.
keywordObligatorio- La acción
searchbusca pistas,search_usersbusca autores ysearch_playlistsbusca listas de reproducción. Aunque las tres usan una palabra clave, devuelven objetos diferentes. La acciónplaylistsolo usa este campo como término de búsqueda si no reconoce una URL de lista con/sets/; no equivale a obtener los detalles exactos de una lista.SoundCloud: atribución de listas de reproducción, álbumes y pistasLa documentación oficial explica que una lista de reproducción es una colección que puede incluir pistas propias o de terceros, y que puede configurarse como un álbum. Por tanto, el creador de la colección no es necesariamente el autor de cada pista; esta API devuelve un resumen de la colección y no replica la función oficial de editar listas.Consultada
¿Qué significan los parámetros de SoundCloud track?
Abre la url de una pista y recoge metadatos, artista, duración y métricas públicas. No descarga el audio, no concede licencia y no conserva un historial de reproducciones.
urlObligatorio- Para
track, usa el enlace de una pista específica. Paraartist, usa la página principal del autor (soundcloud.com/autor); si envías un enlace de pista, se extraerá la ruta del autor. Paraplaylist, usa la URL completa de la lista que contenga/sets/. Las URLs que no sean de listas se tratarán como una búsqueda de listas, y no se garantiza que el resultado sea el objetivo original.SoundCloud: todos los derechos reservados y Creative CommonsLas directrices oficiales de licencias distinguen entre Todos los derechos reservados y las distintas condiciones de `Creative Commons`. El campo `license` sirve como pista para verificar los derechos, no es una autorización universal para uso comercial o reutilización arbitraria; la viabilidad de un uso específico requiere comprobar las condiciones correspondientes.Consultada
¿Qué significan los parámetros de SoundCloud artist?
Consulta la url de un artista o usuario y devuelve perfil, ubicación y contadores visibles. No valida la identidad ni expone oyentes, ingresos o analítica privada.
urlObligatorio- Para
track, usa el enlace de una pista específica. Paraartist, usa la página principal del autor (soundcloud.com/autor); si envías un enlace de pista, se extraerá la ruta del autor. Paraplaylist, usa la URL completa de la lista que contenga/sets/. Las URLs que no sean de listas se tratarán como una búsqueda de listas, y no se garantiza que el resultado sea el objetivo original.SoundCloud: un perfil puede pertenecer a un músico, una banda o un oyenteLa categoría de perfiles y personas de SoundCloud incluye músicos, bandas, creadores y oyentes. Aquí, `artist` es simplemente el nombre de consulta de esta pasarela y no certifica que cualquier perfil corresponda a un artista profesional.Consultada
¿Qué significan los parámetros de SoundCloud playlist?
Abre la url de una playlist, con keyword o query compatibles, y devuelve descripción, duración, pistas e interacciones cuando existen. No modifica la lista ni garantiza disponibilidad regional.
urlObligatorio- Para
track, usa el enlace de una pista específica. Paraartist, usa la página principal del autor (soundcloud.com/autor); si envías un enlace de pista, se extraerá la ruta del autor. Paraplaylist, usa la URL completa de la lista que contenga/sets/. Las URLs que no sean de listas se tratarán como una búsqueda de listas, y no se garantiza que el resultado sea el objetivo original.SoundCloud: la información de la colección y el detalle de las pistas son conceptos distintosLa plataforma describe una lista de reproducción como un conjunto de pistas y explica cómo ajustar el formato de álbum o lista. Esta referencia solo ilustra la relación entre objetos; esta API no devuelve el detalle de `tracks`, y la capacidad oficial de la lista no garantiza el volumen de salida de esta API.Consultada keywordOpcional- La acción
searchbusca pistas,search_usersbusca autores ysearch_playlistsbusca listas de reproducción. Aunque las tres usan una palabra clave, devuelven objetos diferentes. La acciónplaylistsolo usa este campo como término de búsqueda si no reconoce una URL de lista con/sets/; no equivale a obtener los detalles exactos de una lista. queryOpcional- Entrada de compatibilidad para la palabra clave de búsqueda en
playlist. Tiene menor prioridad quekeyword. No elimina el requisito de queurlsea un campo obligatorio.
Cómo usar la API de SoundCloud
- 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":"soundcloud","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de SoundCloud
¿Cómo llamo a la API de SoundCloud?
Envía POST /api/v1/social con platform igual a soundcloud, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de SoundCloud?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, genre y tags. 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 SoundCloud?
La búsqueda de SoundCloud trata Tracks, People y Playlists como objetos distintos; una cuenta puede representar a un artista, banda u oyente. EveryInfra usa acciones separadas y no hereda todos los filtros del sitio web.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; search_users requiere keyword; search_playlists requiere keyword; consulta las demás acciones en la lista de funciones.