---
title: "Keyword Metrics - History"
method: GET
path: "/keywords/metrics/history.json"
---

# Keyword Metrics - History

`GET /keywords/metrics/history.json`

Get historical metrics of a keyword (volume) for a given date range. If you want to have live data for keyword metrics, please see <a href="https://developers.apptweak.com/reference/keyword-metrics-current" target="_blank">Keyword Metrics - Current</a>

## Query parameters

- `keywords` string, required
- `metrics` string, required
- `country` string
- `language` string
- `device` 'iphone' | 'ipad' | 'android'
- `start_date` string
- `end_date` string

## Response `200`

200

- object
  - `result` object
    - `karaoke` object
      - `volume` object[]
        - `date` string
        - `value` integer
      - `results` object[]
        - `date` string
        - `value` integer
  - `metadata` object
    - `request` object
      - `path` string
      - `params` object
        - `device` string
        - `country` string
        - `language` string
        - `start_date` string
        - `end_date` string
        - `keywords` string[]
        - `metrics` string[]
      - `cost` integer
      - `max_credit_cost` integer
      - `status` integer
    - `response` unknown

---

[API](https://skmtc.net/apptweak/apis/apptweak-store-api.md) · [All operations](https://skmtc.net/apptweak/apis/apptweak-store-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apptweak/apptweak-store-api/versions/636adc3c51f1/schema)