---
title: "Keyword Lookup"
method: POST
path: "/data/keyword/lookup"
tags: ["Keyword"]
---

# Keyword Lookup

`POST /data/keyword/lookup`

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

This endpoint allows you to get the search score for a specific keyword. Keywords that haven't been tracked can take up to 120 seconds to return a result.<br/>

Credit Cost: 10

## Request body

- object
  - `device` string, required: iphone / play
  - `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: The limit for the number of results to return (default is all)

## Response `200`

Successful operation

- object
  - `message` string: The response message
  - `response` object: The response object
    - `device` string: iphone / play
    - `keyword` string: Search term
    - `language` string: Language code, e.g., 'en-US'
    - `market` string: IOS / PLAY
    - `maxEstimatedDailyImpressions` integer: Estimated maximum daily impressions for this keyword
    - `results` object[]: List of apps ranked for the keyword, sorted by ascending rank (1 = highest).
      - `appid` string: App ID
      - `category` string: App category
      - `developer` string: App developer name
      - `subtitle` string: App subtitle. For Google Play, this is the short description.
      - `title` string: App title
    - `searchScore` integer: Score for the keyword
    - `searchScoreDate` string: Date/time the search score was recorded (YYYY-MM-DD HH:MM:SS)
    - `totalResults` integer: Number of apps returned in the results

## Other responses

- `202`: Keyword is not tracked yet and its data is still being collected. Retry after the number of seconds given in retryAfter / the Retry-After header.
- `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)