Find emerging keywords
The tool finds queries whose growth has held, or is speeding up, over several whole periods. It uses the same rules as find_content_decay, with the direction reversed. It reads impressions, not clicks. An emerging query is one people ask more often, and clicks lag by however long the page takes to rank. A query with rising impressions and flat clicks is a row to act on. pattern is accelerating if the last rise was bigger than the one before it. noveltyStatus is new if the query had no impressions at the start of the window. On Bing, noveltyStatus is always unsupported, because a query that appears there may only have entered the top-results list. If Google cut the window, the same doubt applies to Google. 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_emerging_keywordsThe tool finds queries whose growth has held, or is speeding up, over several whole periods.
It uses the same rules as find_content_decay, with the direction reversed. It reads impressions, not clicks. An emerging query is one people ask more often, and clicks lag by however long the page takes to rank. A query with rising impressions and flat clicks is a row to act on.
pattern is accelerating if the last rise was bigger than the one before it. noveltyStatus is new if the query had no impressions at the start of the window. On Bing, noveltyStatus is always unsupported, because a query that appears there may only have entered the top-results list. If Google cut the window, the same doubt applies to Google.
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. |
granularity | "weekly" | "monthly" | No | Length of one period in the series: weekly or monthly. Daily is not offered. These tools ask whether a change held across periods, and a one-day period would measure weekday patterns instead. Defaults to "monthly". |
periods | integer | No | How many whole periods to read. If the period that contains the end date is still in progress, the tool leaves it out. The response names that period in periodWindow.excludedPartialPeriod. Defaults to 6. |
to | string | No | Last day of the current window (YYYY-MM-DD). Defaults to the most recent date either engine has data for. |
minImpressions | integer | No | Minimum impressions over the whole window. Keep this low. An emerging query is small by definition. Defaults to 20. |
minRisingPeriods | integer | No | Consecutive rising periods required to qualify. Defaults to 3. |
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." }, "granularity": { "default": "monthly", "description": "Length of one period in the series: weekly or monthly. Daily is not offered. These tools ask whether a change held across periods, and a one-day period would measure weekday patterns instead.", "type": "string", "enum": [ "weekly", "monthly" ] }, "periods": { "default": 6, "type": "integer", "minimum": 2, "maximum": 104, "description": "How many whole periods to read. If the period that contains the end date is still in progress, the tool leaves it out. The response names that period in periodWindow.excludedPartialPeriod." }, "to": { "description": "Last day of the current window (YYYY-MM-DD). Defaults to the most recent date either engine has data for.", "type": "string" }, "minImpressions": { "default": 20, "description": "Minimum impressions over the whole window. Keep this low. An emerging query is small by definition.", "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "minRisingPeriods": { "default": 3, "description": "Consecutive rising periods required to qualify.", "type": "integer", "minimum": 2, "maximum": 12 }, "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" ] }, "periodWindow": { "type": "object", "properties": { "granularity": { "type": "string" }, "periods": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "window": { "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" } }, "required": [ "start", "end" ], "additionalProperties": false }, "periodStarts": { "type": "array", "items": { "type": "string" } }, "excludedPartialPeriod": { "anyOf": [ { "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" } }, "required": [ "start", "end" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "granularity", "periods", "window", "periodStarts", "excludedPartialPeriod" ], "additionalProperties": {} }, "rows": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "google": { "anyOf": [ { "type": "object", "properties": { "pattern": { "type": "string" }, "risingPeriods": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "growthRatio": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "noveltyStatus": { "type": "string" }, "latestClicks": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "latestImpressions": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "series": { "type": "array", "items": { "type": "object", "properties": { "periodStart": { "type": "string" }, "clicks": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "impressions": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "position": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "periodStart", "clicks", "impressions", "position" ], "additionalProperties": {} } } }, "required": [ "pattern", "risingPeriods", "growthRatio", "noveltyStatus", "latestClicks", "latestImpressions", "series" ], "additionalProperties": {} }, { "type": "null" } ] }, "bing": { "anyOf": [ { "type": "object", "properties": { "pattern": { "type": "string" }, "risingPeriods": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "growthRatio": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "noveltyStatus": { "type": "string" }, "latestClicks": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "latestImpressions": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "series": { "type": "array", "items": { "type": "object", "properties": { "periodStart": { "type": "string" }, "clicks": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "impressions": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "position": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "periodStart", "clicks", "impressions", "position" ], "additionalProperties": {} } } }, "required": [ "pattern", "risingPeriods", "growthRatio", "noveltyStatus", "latestClicks", "latestImpressions", "series" ], "additionalProperties": {} }, { "type": "null" } ] }, "totalLatestImpressions": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "label", "google", "bing", "totalLatestImpressions" ], "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", "periodWindow", "rows", "unsupportedInputs" ], "additionalProperties": false}