API para App Store

API para App Store: Avaliações

Obtenha avaliações da App Store de qualquer app iOS pelo ID do app, em qualquer país de loja: notas, títulos e texto das avaliações.

POST/v1/run/appstore.reviews
Disponibilidade
100,00%
30d · 46 chamadas
Requisições
46
30d · semanal, últimas 12 sem.
Resposta
9,9s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `helpfulVotes` ou `version`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma avaliação que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
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": {
    "items": [
      {
        "appId": "a1b2c3d4",
        "author": "Alex Rivera",
        "createdUtc": 12.5,
        "helpfulVotes": 42,
        "id": "a1b2c3d4",
        "rating": 4.6,
        "text": "A short example description of this item.",
        "title": "Example title",
        "url": "https://example.com/page",
        "version": "example"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface AppstoreReviewsResponse {
  data: {
    items: {
      appId?: string;
      author?: string;
      createdUtc?: number;
      helpfulVotes?: number;
      id?: string;
      rating: number;
      text: string;
      title?: string;
      url?: string;
      version?: 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/appstore.reviews
curl -X POST https://api.getanyapi.com/v1/run/appstore.reviews \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appId":"389801252","country":"us","limit":3}'
CampoTipoValor de exemplo
Corpo da requisição
appIdstring"389801252"ID numérico do app na App Store, os dígitos no final da URL do app na loja sem o prefixo 'id' (ex.: 310633997).
countrystring"us"Código de país de duas letras da loja da App Store de onde ler as avaliações.
limitinteger3Número máximo de resultados a retornar (1-100, padrão 100).
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `helpfulVotes` ou `version`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma avaliação que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Resposta
dataobjectThe result wrapper, or null when nothing was found.
data.itemsobject[]Review records: star rating, review title and text, reviewer nickname, app version, and review date. Populated whenever the provider has data for the entity.
data.items[].appIdpode ser exigidostringApp Store numeric app identifier the review belongs to.
data.items[].authorstringReviewer nickname. Populated whenever the provider has data for the entity.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the review was posted. Populated whenever the provider has data for the entity.
data.items[].helpfulVotespode ser exigidointegerNumber of helpful votes on the review.
data.items[].idstringReview identifier. Populated whenever the provider has data for the entity.
data.items[].ratingnumberStar rating, 1 to 5. Populated whenever the provider has data for the entity.
data.items[].textstringReview body text. Populated whenever the provider has data for the entity.
data.items[].titlestringReview title.
data.items[].urlpode ser exigidostringPublic App Store page for this review, when supplied by the serving lane.
data.items[].versionpode ser exigidostringApp version the review was left on.
foundbooleanTrue when at least one review record was returned.
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,0009
Preço /mil req.USDUS$ 0,90

Dúvidas frequentes

Sobre o endpoint Avaliações da API para App Store

O endpoint Avaliações da AnyAPI para App Store retorna dados de App Store em JSON normalizado com uma chamada POST para /v1/run/appstore.reviews. Obtenha avaliações da App Store de qualquer app iOS pelo ID do app, em qualquer país de loja: notas, títulos e texto das avaliações. A AnyAPI distribui cada requisição entre 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,90 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Avaliações da API para App Store feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 9,9 segundos, em 46 chamadas medidas.

Custa a partir de US$ 0,90 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.

Obtenha avaliações da App Store de qualquer app iOS pelo ID do app, em qualquer país de loja: notas, títulos e texto das avaliações. 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 Avaliações da API para App Store feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 9,9 segundos, em 46 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.