API para Spotify

API para Spotify: Buscar

Busque no Spotify faixas, álbuns, artistas, podcasts e playlists correspondentes por palavra-chave.

POST/v1/run/spotify.search
Disponibilidade
100,00%
30d · 6 chamadas
Requisições
6
30d
Resposta
7,9s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "albums": [
      {
        "artistName": "Example title",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "name": "Example title",
        "type": "general",
        "uri": "example",
        "year": 2024
      }
    ],
    "artists": [
      {
        "id": "a1b2c3d4",
        "name": "Example title",
        "uri": "example",
        "verified": true
      }
    ],
    "podcasts": [
      {
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "name": "Example title",
        "publisher": "example",
        "uri": "example"
      }
    ],
    "tracks": [
      {
        "albumName": "Example title",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "name": "Example title",
        "uri": "example"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface SpotifySearchResponse {
  data: {
    albums: {
      artistName?: string;
      id: string;
      image?: string;
      name: string;
      type?: string;
      uri: string;
      year: number;
    }[];
    artists: {
      id: string;
      name: string;
      uri: string;
      verified: boolean;
    }[];
    podcasts: {
      id: string;
      image?: string;
      name: string;
      publisher: string;
      uri?: string;
    }[];
    tracks: {
      albumName?: string;
      id: string;
      image?: string;
      name: string;
      uri: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/spotify.search
curl -X POST https://api.getanyapi.com/v1/run/spotify.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"my first million"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"my first million"Termo de busca (ex.: "my first million").
Resposta
dataobject
data.albumsobject[]Populated whenever the provider has data for the entity.
data.albums[].artistNamestringName of the primary artist.
data.albums[].idstring
data.albums[].imagestringURL of the cover art image.
data.albums[].namestring
data.albums[].typestringAlbum type, for example ALBUM, SINGLE or COMPILATION.
data.albums[].uristring
data.albums[].yearinteger
data.artistsobject[]Populated whenever the provider has data for the entity.
data.artists[].idstring
data.artists[].namestring
data.artists[].uristring
data.artists[].verifiedboolean
data.podcastsobject[]Populated whenever the provider has data for the entity.
data.podcasts[].idstring
data.podcasts[].imagestringURL of the cover art image.
data.podcasts[].namestring
data.podcasts[].publisherstring
data.podcasts[].uristringSpotify URI of the podcast show.
data.tracksobject[]Populated whenever the provider has data for the entity.
data.tracks[].albumNamestringName of the album the track appears on.
data.tracks[].idstringPopulated whenever the provider has data for the entity.
data.tracks[].imagestringURL of the cover art image.
data.tracks[].namestringPopulated whenever the provider has data for the entity.
data.tracks[].uristringPopulated whenever the provider has data for the entity.
foundboolean
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,0012
Preço /mil req.USDUS$ 1,20

Dúvidas frequentes

Sobre o endpoint Buscar da API para Spotify

O endpoint Buscar da AnyAPI para Spotify retorna dados de Spotify em JSON normalizado com uma chamada POST para /v1/run/spotify.search. Busque no Spotify faixas, álbuns, artistas, podcasts e playlists correspondentes por palavra-chave. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Spotify feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 7,9 segundos, em 6 chamadas medidas.

Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque no Spotify faixas, álbuns, artistas, podcasts e playlists correspondentes por palavra-chave. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Spotify feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 7,9 segundos, em 6 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.