---
title: "Keyword App Ranks"
method: POST
path: "/data/keyword/rank"
tags: ["Keyword"]
---

# Keyword App Ranks

`POST /data/keyword/rank`

## 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/rank`
- Auth: API key in header `Authorization`

This endpoint allows you to get the apps ranked for a keyword.<br/>

Credit Cost: 10

## Request body

- object
  - `device` string, required: play / iphone / ipad / mac
  - `keyword` string, required: search term
  - `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, required: The limit

## Response `200`

Successful operation

- object
  - `message` string: The response message
  - `response` object: The response object
    - `date` string: The date of the result (YYYY-MM-DD)
    - `results` object[]: List of ranked apps for the keyword
      - `appid` string: The application ID
      - `rank` integer: The rank of the app for the keyword
      - `title` string: The title of the app

## 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)