---
title: "App Paid Keywords"
method: GET
path: "/apps/keywords/bids.json"
---

# App Paid Keywords

`GET /apps/keywords/bids.json`

Get an app's all time paid keywords, and the number of bids found for each.

## Query parameters

- `apps` string, required
- `country` string
- `language` string
- `device` 'iphone' | 'ipad' | 'android'
- `start_date` string
- `end_date` string
- `aggregated` boolean

## Response `200`

200

- union
  - object
    - `result` object
      - `585629514` object
        - `bids` object[]
          - `date` string
          - `keyword` string
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `language` string
          - `start_date` string
          - `end_date` string
          - `apps` string[]
          - `aggregated` boolean
        - `cost` integer
        - `max_credit_cost` integer
        - `status` integer
      - `response` unknown
  - object
    - `result` object
      - `com.getsomeheadspace.android` object
        - `bids` object[]
          - `date` string
          - `keyword` string
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `language` string
          - `start_date` string
          - `end_date` string
          - `apps` string[]
          - `aggregated` boolean
        - `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)