Search Terms
GET /api/v1/accounts/{projectId}/search-terms
The queries that actually triggered ads.
GET /api/v1/accounts/{projectId}/search-termsThe queries that actually triggered ads.
Requires a key with read scope or higher.
Returns 200 on success.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | The Google Ads account, as returned by GET /api/v1/accounts. |
days | query | number | no | Lookback window in complete days, ending yesterday. Today's metrics are still accumulating, so they are excluded. |
limit | query | number | no | Maximum rows to return. |
campaign_id | query | string | no | Restrict to one campaign. |
ad_group_id | query | string | no | Restrict to one ad group. |
min_clicks | query | number | no | Drop terms below this click count. Defaults to 1 — the zero-click tail is enormous and rarely actionable. |
Example
curl -X GET "https://bidandscale.com/api/v1/accounts/{projectId}/search-terms" \
-H "Authorization: Bearer $BIDANDSCALE_API_KEY"