---
title: "One rival of your app in one storefront: its name, rating and rating count with a 90-day history of them…"
method: GET
path: "/apps/{appId}/rivals/{rivalId}"
tags: ["Apps"]
---

# One rival of your app in one storefront: its name, rating and rating count with a 90-day history of them…

`GET /apps/{appId}/rivals/{rivalId}`

## Request

- Base URL: `https://storelift.net/v1`
- URL: `https://storelift.net/v1/apps/{appId}/rivals/{rivalId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

One rival of your app in one storefront: its name, rating and rating count with a 90-day history of them (a name change is how a listing rewrite shows), and the keywords it ranks for with its rank on each. The keyword list uses one keyword spy from the monthly allowance and stays open for 30 days; when the allowance is used up the answer carries the rival's own figures with `locked: true`.

## Path parameters

- `appId` string, required
- `rivalId` string, required

## Query parameters

- `country` string
- `platform` 'ios' | 'android'

## Response `200`

OK

- object

## Other responses

- `400`: A parameter is missing or malformed.
- `401`: No key, or the key is not valid.
- `402`: This month's credits are used up.
- `403`: The key's plan or scopes do not cover this call.
- `404`: No such app, or Storelift has not measured it yet.
- `429`: Too many requests.

---

[API](https://skmtc.dev/storelift/apis/storelift-api.md) · [All operations](https://skmtc.dev/storelift/apis/storelift-api/llms.txt) · [OpenAPI document](https://skmtc.dev/storelift/apis/storelift-api/revisions/4489f2d077a4?raw)