API de Búsqueda de SoundCloud

Q: ¿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.

Q: ¿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.

POST

Salud de la API

Salud 24 h: Normal
Tiempo medio 24 h: —

Saludable / normal
Disponible
Limitada
Casi sin servicio

Normal

Ú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.

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.

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.

Prompt para IA

Pégalo en tu asistente de IA. Ya incluye los parámetros, los campos de respuesta y una solicitud de ejemplo de este endpoint, así que el asistente puede preguntarte qué necesitas y luego escribir el script.

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra SoundCloud: Búsqueda (soundcloud/search).

Contrato del 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	No declarado	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

bash

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

Respuesta real

Obtenida el 26 de septiembre de 2026, 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.

json

{
  "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. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
422: Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
402: Saldo insuficiente. Recarga primero.
429: Se alcanzó el límite de solicitudes por minuto de la cuenta (todas sus claves API cuentan juntas; antes se aplica el límite propio de una clave si es menor). Espera lo que indique Retry-After y vuelve a intentarlo; un paquete de velocidad en la consola sube el límite.
503: No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
200 vacío: La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).

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