API de plataforma de EveryData

API de Spotify

Q: ¿Cómo llamo a la API de Spotify?

Envía POST /api/v1/social con `platform` igual a `spotify`, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

Q: ¿Qué devuelve la API de Spotify?

Devuelve JSON estructurado. Por ejemplo, el esquema de `profile` incluye `name`, `type`, `release_date` y `label`. 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.

Q: ¿Qué parámetros son obligatorios?

Depende de la acción. `profile` requiere `url`; `search` requiere `keyword`; `artist` requiere `url`; consulta las demás acciones en la lista de funciones.

Busca y consulta artistas, pistas, álbumes, playlists, podcasts y otros objetos públicos de Spotify. La URL y el tipo devuelto conservan la identidad de cada recurso.

Oyentes mensuales y seguidores son lecturas puntuales; no representan ingresos ni historial. El catálogo puede variar por región y ninguna acción reproduce o descarga audio.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 7
Por 1.000: 1,389 US$

Funciones disponibles

Compara las acciones de Spotify 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
`profile` Consultar un objeto de Spotify por URL Consulta la `url` de un objeto de Spotify y devuelve su identidad, tipo, fecha, sello, artistas y pistas cuando corresponden. No reproduce audio ni accede a una cuenta personal autenticada.	url	—	Entrega síncrona	—	$1.39 por 1.000 solicitudes	id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform · duration_ms · play_count · track_number
`search` Buscar contenido en Spotify Busca en Spotify mediante `keyword` y `content_type`, conservando el tipo de pista, álbum, artista, playlist o programa. El resultado no garantiza catálogo idéntico por región ni popularidad histórica.	keyword	content_type	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 · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform
`artist` Consultar un artista de Spotify Abre la `url` de un artista y recoge biografía, géneros, oyentes mensuales, seguidores y ranking visibles. Son señales públicas puntuales, no ingresos ni una serie histórica.	url	—	Entrega síncrona	—	$1.39 por 1.000 solicitudes	id · url · name · bio · monthly_listener_count · follower_count · world_rank · genres · image_url · header_image_url · album_count · single_count · compilation_count · top_cities · top_tracks · related_artists · platform · city · country · region · listener_count
`track` Consultar los datos de una pista Consulta la `url` de una pista y devuelve la relación con álbum, sello y clasificación de contenido cuando aparecen. No entrega el archivo de audio ni confirma derechos territoriales.	url	—	Entrega síncrona	—	$1.39 por 1.000 solicitudes	album_id · album_type · label · content_rating
`album` Consultar un álbum de Spotify Abre la `url` de un álbum y conserva artistas, fecha, sello, copyright, portada y lista de pistas. No reproduce el contenido ni garantiza que todas las ediciones regionales sean iguales.	url	—	Entrega síncrona	—	$1.39 por 1.000 solicitudes	id · url · name · album_type · artists · release_date · label · copyright · track_count · image_url · tracks · platform
`playlist` Consultar una playlist de Spotify Consulta la `url` de una playlist y devuelve propietario, descripción, seguidores y pistas visibles. No modifica la lista, no revela seguidores nominales ni asegura que cada tema siga disponible.	url	—	Entrega síncrona	—	$1.39 por 1.000 solicitudes	id · url · name · text · owner_name · save_count · follower_count · track_count · image_url · tracks · platform
`podcast` Buscar programas y episodios Busca programas o episodios con `keyword` y el `content_type` admitido. Conserva el tipo devuelto para no confundir show y episodio; no descarga audio ni accede a suscripciones privadas.	keyword	content_type	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 · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform

¿Qué acepta cada acción de Spotify?

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 Spotify `profile`?

Consulta la url de un objeto de Spotify y devuelve su identidad, tipo, fecha, sello, artistas y pistas cuando corresponden. No reproduce audio ni accede a una cuenta personal autenticada.

urlObligatorio: Para artist, track, album o playlist, usa el enlace correspondiente de open.spotify.com. También puedes enviar spotify:tipo:ID o solo el ID en el parámetro url. El tipo de objeto lo determina la action; no mezcles tipos. La acción profile (obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.
Spotify: URL, URI e identificador de recursoSpotify diferencia URL, URI, ID e identificador de usuario. Cada acción de EveryInfra acepta la entrada que documenta; que dos cadenas identifiquen el mismo recurso en Spotify no las vuelve intercambiables aquí.Consultada 2026-09-04

¿Qué significan los parámetros de Spotify `search`?

Busca en Spotify mediante keyword y content_type, conservando el tipo de pista, álbum, artista, playlist o programa. El resultado no garantiza catálogo idéntico por región ni popularidad histórica.

keywordObligatorio: Término de búsqueda de música para search. El tipo de contenido se selecciona con content_type. La acción podcast busca programas de pódcast por defecto, no es una consulta de detalles de episodios.
content_typeOpcional: Para search, usa tracks (pistas), artists (artistas), albums (álbumes) o playlists (listas de reproducción). La ruta podcast tiene otro conjunto de valores permitidos: el valor por defecto es podcasts_shows (programas) y podcast_episodes_individual_episodes (episodios individuales). Si lo cambias a categorías no predeterminadas como audiolibros, comprueba si los campos de resultados están completos. No se puede garantizar una nueva funcionalidad basándose solo en esto.
Valores permitidos:albumsartistsplayliststracks

¿Qué significan los parámetros de Spotify `artist`?

Abre la url de un artista y recoge biografía, géneros, oyentes mensuales, seguidores y ranking visibles. Son señales públicas puntuales, no ingresos ni una serie histórica.

urlObligatorio: Para artist, track, album o playlist, usa el enlace correspondiente de open.spotify.com. También puedes enviar spotify:tipo:ID o solo el ID en el parámetro url. El tipo de objeto lo determina la action; no mezcles tipos. La acción profile (obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.
Spotify: diferencias de criterio entre oyentes mensuales y oyentes activos mensualesSpotify define a los oyentes mensuales como aquellos de los últimos 28 días, incluyendo fuentes activas y recomendaciones algorítmicas; los oyentes activos mensuales son solo el subconjunto que escucha de forma activa. El campo `monthly_listener_count` de esta página no debe interpretarse como dicho subconjunto, ni como el número de reproducciones o de seguidores.Consultada 2026-09-04

¿Qué significan los parámetros de Spotify `track`?

Consulta la url de una pista y devuelve la relación con álbum, sello y clasificación de contenido cuando aparecen. No entrega el archivo de audio ni confirma derechos territoriales.

urlObligatorio: Para artist, track, album o playlist, usa el enlace correspondiente de open.spotify.com. También puedes enviar spotify:tipo:ID o solo el ID en el parámetro url. El tipo de objeto lo determina la action; no mezcles tipos. La acción profile (obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.
Spotify: un ID aislado no indica el tipo de recursoLa documentación oficial aclara que un ID de Spotify por sí solo no especifica el tipo de recurso, ya que este lo proporciona el contexto de la llamada, mientras que el URI sí incluye dicha información. Es imprescindible que la acción, la ruta del enlace y el objeto del ID coincidan; no se puede depender de la misma cadena de caracteres para convertir automáticamente entre distintos recursos.Consultada 2026-09-04
Spotify: límites de uso entre la pista, el álbum al que pertenece y el contenidoLa documentación oficial de pistas distingue entre los objetos `track` y `album`, y detalla por separado las restricciones de atribución, descarga y uso en modelos. Esta consulta de metadatos no otorga permisos para descargar el audio completo ni para entrenar modelos; los campos adicionales oficiales y el parámetro `market` tampoco forman parte automática del contrato de EveryInfra.Consultada 2026-09-04

¿Qué significan los parámetros de Spotify `album`?

Abre la url de un álbum y conserva artistas, fecha, sello, copyright, portada y lista de pistas. No reproduce el contenido ni garantiza que todas las ediciones regionales sean iguales.

urlObligatorio: Para artist, track, album o playlist, usa el enlace correspondiente de open.spotify.com. También puedes enviar spotify:tipo:ID o solo el ID en el parámetro url. El tipo de objeto lo determina la action; no mezcles tipos. La acción profile (obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.
Spotify: un ID aislado no indica el tipo de recursoLa documentación oficial aclara que un ID de Spotify por sí solo no especifica el tipo de recurso, ya que este lo proporciona el contexto de la llamada, mientras que el URI sí incluye dicha información. Es imprescindible que la acción, la ruta del enlace y el objeto del ID coincidan; no se puede depender de la misma cadena de caracteres para convertir automáticamente entre distintos recursos.Consultada 2026-09-04

¿Qué significan los parámetros de Spotify `playlist`?

Consulta la url de una playlist y devuelve propietario, descripción, seguidores y pistas visibles. No modifica la lista, no revela seguidores nominales ni asegura que cada tema siga disponible.

urlObligatorio: Para artist, track, album o playlist, usa el enlace correspondiente de open.spotify.com. También puedes enviar spotify:tipo:ID o solo el ID en el parámetro url. El tipo de objeto lo determina la action; no mezcles tipos. La acción profile (obsoleta) solo acepta la URL completa para obtener datos de reproducción de álbumes o sencillos, no perfiles de usuario.
Spotify: un ID aislado no indica el tipo de recursoLa documentación oficial aclara que un ID de Spotify por sí solo no especifica el tipo de recurso, ya que este lo proporciona el contexto de la llamada, mientras que el URI sí incluye dicha información. Es imprescindible que la acción, la ruta del enlace y el objeto del ID coincidan; no se puede depender de la misma cadena de caracteres para convertir automáticamente entre distintos recursos.Consultada 2026-09-04

¿Qué significan los parámetros de Spotify `podcast`?

Busca programas o episodios con keyword y el content_type admitido. Conserva el tipo devuelto para no confundir show y episodio; no descarga audio ni accede a suscripciones privadas.

keywordObligatorio: Término de búsqueda de música para search. El tipo de contenido se selecciona con content_type. La acción podcast busca programas de pódcast por defecto, no es una consulta de detalles de episodios.
content_typeOpcional: Para search, usa tracks (pistas), artists (artistas), albums (álbumes) o playlists (listas de reproducción). La ruta podcast tiene otro conjunto de valores permitidos: el valor por defecto es podcasts_shows (programas) y podcast_episodes_individual_episodes (episodios individuales). Si lo cambias a categorías no predeterminadas como audiolibros, comprueba si los campos de resultados están completos. No se puede garantizar una nueva funcionalidad basándose solo en esto.
Valores permitidos:albums_full_releasesartists_musicians_bandsaudiobooks_spoken_word_booksplaylists_curated_collectionspodcast_episodes_individual_episodespodcasts_showssongs_individual_tracks
Spotify: un programa de pódcast y un episodio son objetos diferentesLa plataforma utiliza la página del programa para organizar sus episodios disponibles, y explica por separado cómo seguir un programa y cómo guardar un episodio. Aquí solo se expone la relación jerárquica; no se replican las capacidades del cliente de Spotify para reproducir, descargar sin conexión o suscribirse a contenido de pago.Consultada 2026-09-04

Cómo usar la API de Spotify

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.

spotify_profile.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"spotify","action":"profile","params":{"url":"<url>"}}'

Preguntas sobre la API de Spotify

¿Cómo llamo a la API de Spotify?

Envía POST /api/v1/social con platform igual a spotify, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de Spotify?

Devuelve JSON estructurado. Por ejemplo, el esquema de profile incluye name, type, release_date y label. 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 Spotify?

Spotify diferencia URL, URI, ID e identificador de usuario. Cada acción de EveryInfra acepta la entrada que documenta; que dos cadenas identifiquen el mismo recurso en Spotify no las vuelve intercambiables aquí.

¿Qué parámetros son obligatorios?

Depende de la acción. profile requiere url; search requiere keyword; artist requiere url; consulta las demás acciones en la lista de funciones.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API Ver el catálogo público →