Read paid terms without a ranking
get_google_ads_terms_without_rankingThe connected Google Ads account's paid search terms that the site has no organic position for, most spend first, with cost and conversions for a date range, and each term's organic clicks, impressions and Search Console average position where Search Console has them (organicState says whether it was read): the spend organic work could replace. Positions come from the project's rank tracking of its own site, read from saved checks; nothing is bought or fetched. tracked: true means the last check did not find the site; tracked: false means the term is not tracked, so its position is unknown (add it to rank tracking to check). Performance Max search categories are not included: they group searches and are not exact terms a rank check can look up. Money is in the account's currency (currencyCode); at most 90 days. Read-only; uses no credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "get_google_ads_terms_without_ranking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return (default 100, max 500). | |
| endDate | No | Last day (YYYY-MM-DD). Use with startDate. Without both, the last 30 stored days. At most 90 days. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| startDate | No | First day (YYYY-MM-DD, the Ads account's time zone). Use with endDate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| meta | No | ||
| note | No | ||
| rows | No | ||
| reason | No | ||
| endDate | No | ||
| hasMore | No | ||
| message | No | ||
| failedAt | No | ||
| rowCount | No | ||
| startDate | No | ||
| connectUrl | No | ||
| accountName | No | ||
| accountSpend | No | ||
| currencyCode | No | ||
| organicState | No | ||
| storedThrough | No | ||
| searchCategories | No |