Capítulo 1. O que é uma API da Play Store e o que ela não é

A diferença entre a API de desenvolvedores do Google e uma API de dados de páginas, e por que a segunda existe.

Pesquise «Play Store API» e você encontrará duas coisas bem diferentes com o mesmo nome.

A Play Developer API do Google

O Google publica a Google Play Developer API para os donos de apps. Com uma conta de serviço vinculada ao seu Play Console, você envia builds, edita sua página, lê e responde avaliações e verifica compras. Ela nunca devolve dados de apps que não são seus e não tem busca.

Uma API de dados de páginas

O outro tipo trata a Play Store como um catálogo público. Ela lê as páginas públicas (qualquer pessoa pode abri-las no navegador) e as entrega em JSON: um app pelo nome do pacote, ou muitos por gênero, instalações, avaliação ou data. É disso que precisam pesquisas de mercado, diretórios de apps, ferramentas de ASO e analistas, e é disso que trata este manual.

O que um registro de página contém

• Identidade: nome do pacote, título, editora, gênero.
• Popularidade: faixa de instalações e uma estimativa, avaliação, número de avaliações e resenhas.
• Comércio: preço, compras no app, anúncios.
• Ciclo de vida: data de lançamento, última atualização, versão atual, versão do Android exigida.
• Mídia: ícone, capturas de tela, vídeo.

O que ele não contém

Nada de arquivos APK, números privados de vendas ou textos de resenhas. As instalações são as faixas públicas do Google mais uma estimativa, não os números do Play Console. Os rankings são instantâneos, não um fluxo ao vivo.

A primeira requisição

curl -H "X-API-Key: $API_KEY" \
  "https://playapi.info/api/v1/app?id=com.duolingo"

O próximo capítulo repete isso em Python e acrescenta busca e paginação.