API de Búsqueda de SoundCloud
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
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.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a soundcloud y action igual a search. Precio $1.39 por 1.000 solicitudes ($0.001389 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.
SoundCloud Búsqueda encuentra pistas por keyword y devuelve, para cada una, el título, la descripción, el género, las etiquetas, la duración, la portada, la licencia, la fecha de publicación y el enlace; las cifras de reproducciones, me gusta, comentarios, republicaciones y descargas, y el nombre, el perfil, el avatar, los seguidores y la verificación del artista. Sirve para explorar lo que se sube en torno a un estilo o un tema, descubrir artistas emergentes y reunir pistas para un análisis musical o una selección.
keyword busca solo pistas: las cuentas y las listas tienen sus propias búsquedas. duration_sec está en segundos, no en milisegundos como en otras plataformas. Un null en like_count, comment_count o repost_count es una cifra no publicada, no un cero. Los resultados son una muestra de lo que coincide con la palabra clave, no todas las subidas relacionadas, así que tenlo en cuenta antes de sacar totales.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra SoundCloud: Búsqueda (soundcloud/search).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en soundcloud y action en search, y los parámetros dentro de params.
- Parámetros obligatorios:
- keyword: La acción search busca pistas, search_users busca autores y search_playlists busca listas de reproducción. Aunque las tres usan una palabra clave, devuelven objetos diferentes.
- Parámetros opcionales:
- limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 100. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: id, url, title, text, genre, tags, duration_sec, duration_seconds, artist_name, artist_url, artist_avatar_url, artist_follower_count; 21 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=soundcloud.
- Cuerpo de solicitud de ejemplo:
{
"platform": "soundcloud",
"action": "search",
"params": {
"keyword": "ambient piano"
}
}
- Precio: $1.39 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | soundcloud | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | search | Identificador de la capacidad, valor fijo. |
keyword | body.params | string | Sí | - | La acción search busca pistas, search_users busca autores y search_playlists busca listas de reproducción. Aunque las tres usan una palabra clave, devuelven objetos diferentes. La acción playlist solo 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. |
limit | body.params | integer (1–100) | No | 20 | Número máximo de filas que devuelve esta llamada, un entero de 1 a 100. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro. |
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "soundcloud",
"action": "search",
"params": {
"keyword": "ambient piano"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Ejemplo de respuesta
#{ "id": "req_…", "platform": "soundcloud", "action": "search", "results": [ { "id": 1766135160, "url": "https://soundcloud.com/ambientmusicalgenre/good-lee-bliss-in-chaos-piano-edit", "title": "Good Lee - Bliss in Chaos (Piano Edit)", "text": "🎇 Bliss in Chaos.\n🎧 Stream: https://open.spotify.com/track/5TaBEN8vARmiaPrteQmqpy\n🌆 Spotify Ambient Playlist: http://bit.ly/AmbientSpotify\n\n🎊 Subscribe to Ambient and click on the bell for more wonderful music!\n\n📸 Ambient Instagram: http://bit.ly/AmbientInstagram\n🎁 Ambient Shop: …", "genre": "Ambient", "tags": [ "Classical", "Piano", "Ambient" ], "duration_sec": 202, "artist_name": "Ambient", "artist_url": "https://soundcloud.com/ambientmusicalgenre", "artist_avatar_url": "https://i1.sndcdn.com/•••", "artist_follower_count": 57569, "artist_verified": false, "play_count": 1524, "like_count": 33, "comment_count": 1, "repost_count": 4, "download_count": 0, "artwork_url": "https://i1.sndcdn.com/artworks-Q6zUENkFLRjlrWa7-Ji7q8w-large.jpg", "license": "all-rights-reserved", "posted_at": "2024-03-05T19:06:52+00:00", "platform": "soundcloud" }, { "id": 1289751166, "url": "https://soundcloud.com/esteban-martinez-749274166/the-owl-house-outro-ambient", "title": "The Owl House - Outro ( Ambient Piano Lofi )", "text": "", "genre": "Ambient", "tags": [], "duration_sec": 141, "artist_name": "Steb", "artist_url": "https://soundcloud.com/esteban-martinez-749274166", "artist_avatar_url": "https://i1.sndcdn.com/•••", "artist_follower_count": 37, "artist_verified": false, "play_count": 70246, "like_count": 469, "comment_count": 56, "repost_count": 13, "download_count": 0, "artwork_url": "https://i1.sndcdn.com/artworks-VKNHiJD2pRuiVmfx-LPQ46w-large.jpg", "license": "all-rights-reserved", "posted_at": "2022-06-18T05:15:45+00:00", "platform": "soundcloud" } ], "count": 20, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
url | Enlace al registro en la plataforma. |
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
text | Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma). |
genre | Conserva el significado de la plataforma |
tags | Lista de etiquetas. Si no hay, es una lista vacía, no null. |
duration_sec | Conserva el significado de la plataforma |
duration_seconds | Duración en segundos. null en contenido que no es video ni audio. |
artist_name | Conserva el significado de la plataforma |
artist_url | Conserva el significado de la plataforma |
artist_avatar_url | Conserva el significado de la plataforma |
artist_follower_count | Conserva el significado de la plataforma |
artist_verified | Conserva el significado de la plataforma |
play_count | Conserva el significado de la plataforma |
like_count | Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0. |
comment_count | Comentarios. null significa no publicado, no 0. |
repost_count | Republicaciones (distintas de las citas). null significa no publicado. |
download_count | Conserva el significado de la plataforma |
artwork_url | Conserva el significado de la plataforma |
license | Conserva el significado de la plataforma |
posted_at | Fecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Preguntas frecuentes
#¿Cómo busco artistas o listas en lugar de pistas?
#Con otras dos capacidades que también reciben una palabra clave: SoundCloud Búsqueda de usuarios para cuentas y SoundCloud Búsqueda de listas de reproducción para listas. Aunque las tres usan keyword, cada una devuelve un tipo de objeto distinto, así que guarda de qué búsqueda viene cada fila.
¿Puedo reutilizar una pista que encuentre?
#Depende de su licencia. Lee license antes de remezclar o reutilizar una pista: indica el tipo de licencia con que se publicó, incluidas las Creative Commons, y cada una fija sus propias condiciones. Guarda ese valor junto a url y artist_name para documentar de dónde sale cada pista que uses.
¿Cómo veo los datos completos del artista de un resultado?
#Cada fila trae lo básico del artista: artist_name, artist_url, artist_follower_count y artist_verified. Para su perfil completo, con biografía, ubicación, número de pistas y fecha de alta, pasa artist_url a SoundCloud Datos del artista. Comparar play_count con artist_follower_count ayuda a ver qué pistas llegan más allá de los seguidores del artista.
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Referencias oficiales
#Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- SoundCloud: pistas, personas y playlists ↗
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.
Comprobado el 2026-09-04