Find low-hanging keywords
The tool finds high-impression queries that rank just off page one, and estimates the extra clicks if they reached the site's own page-one click rate. The estimate uses the site's own rows in the current window, in the position band pos1_3. It is not an industry benchmark. estimatedUpliftClicks is null if the site has too little page-one data of its own to project from. Branded queries are left out by default. A brand query cannot be moved up on the brand's own results, and its high click rate would raise the page-one target every other row is measured against. Set excludeBranded to false to include them. If the workspace has no brand terms, the response says so in unsupportedInputs. Google keeps about 5,000 rows per day for each single breakdown once a day is more than about three days old. On a large site the tool is reading the top queries or pages by impressions. Google no longer stores the rest. If that applies to this window, the response names the dates in unsupportedInputs. A missing row means it was outside that list. Google no longer has the row, so there is nothing further to fetch.
find_low_hanging_keywordsThe tool finds high-impression queries that rank just off page one, and estimates the extra clicks if they reached the site's own page-one click rate.
The estimate uses the site's own rows in the current window, in the position band pos1_3. It is not an industry benchmark. estimatedUpliftClicks is null if the site has too little page-one data of its own to project from.
Branded queries are left out by default. A brand query cannot be moved up on the brand's own results, and its high click rate would raise the page-one target every other row is measured against. Set excludeBranded to false to include them. If the workspace has no brand terms, the response says so in unsupportedInputs.
Google keeps about 5,000 rows per day for each single breakdown once a day is more than about three days old. On a large site the tool is reading the top queries or pages by impressions. Google no longer stores the rest.
If that applies to this window, the response names the dates in unsupportedInputs. A missing row means it was outside that list. Google no longer has the row, so there is nothing further to fetch.
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
site | string | Yes | The site to look up, as a bare domain ("example.com") or a URL. The tool strips the scheme, www, path, and trailing slash. The site must belong to a workspace you own. Call list_sites first if you are not sure of the exact domain. |
windowDays | integer | No | Length of the current window, in days. Defaults to 28. |
to | string | No | Last day of the current window (YYYY-MM-DD). Defaults to the most recent date either engine has data for. |
positionMin | number | No | Lower bound (inclusive) of the 'close to page one' band. Defaults to 4. |
positionMax | number | No | Upper bound (inclusive) of the 'close to page one' band. Defaults to 20. |
minImpressions | integer | No | Minimum current-window impressions to consider a query. Defaults to 10. |
excludeBranded | boolean | No | Drop queries that contain the workspace's brand terms. Read or change those terms with get_workspace_brand_terms and set_workspace_brand_terms. Defaults to true. |
limit | integer | No | Maximum rows to return, sorted by relevance. Defaults to 50. |
searchVertical | "web" | "image" | "video" | No | Which Google search type to read: web (the default), image, or video. Bing Webmaster Tools does not split search types on any traffic report, so image and video return Google only. The response records that Bing was left out, in unsupportedInputs. A missing Bing number then means Bing was not measured. Defaults to "web". |
Full input JSON SchemaTypes, defaults and validation rules
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "site": { "type": "string", "minLength": 1, "description": "The site to look up, as a bare domain (\"example.com\") or a URL. The tool strips the scheme, www, path, and trailing slash. The site must belong to a workspace you own. Call list_sites first if you are not sure of the exact domain." }, "windowDays": { "default": 28, "description": "Length of the current window, in days.", "type": "integer", "exclusiveMinimum": 0, "maximum": 365 }, "to": { "description": "Last day of the current window (YYYY-MM-DD). Defaults to the most recent date either engine has data for.", "type": "string" }, "positionMin": { "default": 4, "description": "Lower bound (inclusive) of the 'close to page one' band.", "type": "number", "minimum": 1 }, "positionMax": { "default": 20, "description": "Upper bound (inclusive) of the 'close to page one' band.", "type": "number", "minimum": 1 }, "minImpressions": { "default": 10, "description": "Minimum current-window impressions to consider a query.", "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "excludeBranded": { "default": true, "description": "Drop queries that contain the workspace's brand terms. Read or change those terms with get_workspace_brand_terms and set_workspace_brand_terms.", "type": "boolean" }, "limit": { "default": 50, "description": "Maximum rows to return, sorted by relevance.", "type": "integer", "exclusiveMinimum": 0, "maximum": 500 }, "searchVertical": { "default": "web", "description": "Which Google search type to read: web (the default), image, or video. Bing Webmaster Tools does not split search types on any traffic report, so image and video return Google only. The response records that Bing was left out, in unsupportedInputs. A missing Bing number then means Bing was not measured.", "type": "string", "enum": [ "web", "image", "video" ] } }, "required": [ "site" ]}Response
Full output JSON SchemaEvery field the response can contain
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "site": { "type": "string" }, "workspaceId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "searchVertical": { "type": "string", "enum": [ "web", "image", "video" ] }, "currentWindow": { "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" } }, "required": [ "start", "end" ], "additionalProperties": false }, "rows": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "google": { "anyOf": [ { "type": "object", "properties": { "position": { "type": "number" }, "impressions": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "clicks": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "ctr": { "type": "number" }, "estimatedUpliftClicks": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "position", "impressions", "clicks", "ctr", "estimatedUpliftClicks" ], "additionalProperties": {} }, { "type": "null" } ] }, "bing": { "anyOf": [ { "type": "object", "properties": { "position": { "type": "number" }, "impressions": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "clicks": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "ctr": { "type": "number" }, "estimatedUpliftClicks": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "position", "impressions", "clicks", "ctr", "estimatedUpliftClicks" ], "additionalProperties": {} }, { "type": "null" } ] } }, "required": [ "label", "google", "bing" ], "additionalProperties": {} } }, "unsupportedInputs": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "engine": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "type": "string" } }, "required": [ "field", "reason" ], "additionalProperties": {} } }, "lastSyncedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "site", "workspaceId", "searchVertical", "currentWindow", "rows", "unsupportedInputs" ], "additionalProperties": false}