---
title: "Keyword Spy"
method: POST
path: "/data/keyword/spy"
tags: ["Keyword"]
---

# Keyword Spy

`POST /data/keyword/spy`

## Request

- Base URL: `https://data.applyzer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://data.applyzer.com/data/keyword/spy`
- Auth: API key in header `Authorization`

This endpoint allows you to get all keywords that an app is ranking for.<br/>

Credit Cost: 5

## Request body

- object
  - `app` string, required: For Android apps this is the package ID like com.example.app. On iOS this is the numeric app ID such as 123456789
  - `device` string, required: play / iphone / ipad / mac
  - `language` string, required: The code for English (United States) 'en-US'. The prefix, 'en', is a language code following the ISO 639-1 standard. The suffix, 'US', is a country code following the ISO 3166-1 Alpha-2 standard
  - `market` string, required: IOS / PLAY
  - `limit` integer: Maximum rank limit to filter results (default is 100, max is 250)
  - `page` integer: Page number for pagination (default is 1)
  - `pageSize` integer: Number of results per page (default is 10, max is 250)

## Response `200`

Successful operation

- object
  - `message` string: The response message
  - `response` object: The response object
    - `app` string: The app ID
    - `device` string: The device type
    - `market` string: The market (IOS/PLAY)
    - `language` string: The language code
    - `limit` integer: The rank limit used for filtering
    - `page` integer: Current page number
    - `pageSize` integer: Number of results per page
    - `totalResults` integer: Total number of keywords found (before pagination)
    - `totalPages` integer: Total number of pages available
    - `keywords` object[]: List of keywords the app is ranking for
      - `keyword` string: The keyword text
      - `rank` integer: The rank of the app for this keyword
      - `searchScore` integer: The search score of the keyword (null if not available)
      - `date` string: The date of the rank (YYYY-MM-DD)

## Other responses

- `404`: No data found
- `500`: Error

---

[API](https://skmtc.dev/applyzer/apis/applyzer-data-api.md) - [All operations](https://skmtc.dev/applyzer/apis/applyzer-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/applyzer/apis/applyzer-data-api/revisions/ffe6cc179bf5?raw)