# Get keyword reports

**GET /accounts/{account_id}/reports/keywords**

Fetch reports for the observed keywords in the given period

Available on: 
![AuditGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/audit-off.png) ![AlertGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/active-off.png) ![PremiumGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/premium-on.png) ![EliteGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/elite-on.png)



## Servers



## Parameters

### Path parameters
- **account_id** (string)
  ID of an account

### Query parameters
- **period** (string)
  Observed period for the report
- **sort** (string)
  Sort the keywords by a specified parameter. Use '-' prefix to indicate a descending sort. Default: '-total_clicks'.
- **offset** (number)
  Paginating parameter. Offset the result by a specified number. Default: 0.
- **limit** (number)
  Paginating parameter. Limit the number of result by a specified number. Max: 100. Default: 50.
- **query** (string)
  Search keywords by given query
- **ids[]** (array[string])
  Fetch all keyword reports for the given array of keyword IDs.


## Responses
### 200
Successful operation

#### Body:  (array[object])
- **id** (string)
  Keyword ID from Google Ads
- **text** (string)
  Keyword text value
- **total_clicks** (number)
  Total number of clicks for this keyword
- **normal_clicks** (number)
  Total number of normal clicks for this keyword
- **suspicious_clicks** (number)
  Total number of suspicious clicks for this keyword
- **flagged_clicks** (number)
  Total number of flagged clicks for this keyword
- **invalid_clicks** (number)
  Total number of invalid clicks for this keyword
- **first_seen** (string(date-time))
  Timestamp of the first occurrence of this keyword
- **last_seen** (string(date-time))
  Timestamp of the last occurrence of this keyword


[Powered by Bump.sh](https://bump.sh)