---
title: "Keyword Live Search - History"
method: GET
path: "/keywords/search-results/history.json"
---

# Keyword Live Search - History

`GET /keywords/search-results/history.json`

Returns historical app results of a search for a given keyword.
For each day in the requested period, this query will return the search result if AppTweak made a search on that date for that keyword.

## Query parameters

- `keyword` string, required
- `country` string
- `language` string
- `device` 'iphone' | 'ipad' | 'android'
- `start_date` string, date
- `end_date` string, date

## Response `200`

200

- union
  - object
    - `result` object[]
      - `date` string
      - `value` integer[]
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `language` string
          - `limit` integer
          - `offset` integer
          - `start_date` string
          - `end_date` string
          - `keyword` string
        - `cost` integer
        - `max_credit_cost` integer
        - `status` integer
      - `response` unknown
  - object
    - `result` object[]
      - `date` string
      - `value` string[]
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `language` string
          - `limit` integer
          - `offset` integer
          - `start_date` string
          - `end_date` string
          - `keyword` 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/revisions/636adc3c51f1/schema)