content_analysis_phrase_trends
Analyze keyword citation trends over time to identify content performance. Track target phrases in specific fields like titles and snippets, filter by page type, and date range for actionable SEO insights.
Instructions
This endpoint will provide you with data on all citations of the target keyword for the indicated date range
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date_from | Yes | starting date of the time range date format: "yyyy-mm-dd" | |
| date_group | No | date grouping type | month |
| date_to | No | ending date of the time range date format: "yyyy-mm-dd" | |
| initial_dataset_filters | No | initial dataset filtering parameters initial filtering parameters that apply to fields in the Search endpoint; you can add several filters at once (8 filters maximum); you should set a logical operator and, or between the conditions; the following operators are supported: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match you can use the % operator with like and not_like to match any string of zero or more characters; example: ["domain","<>", "logitech.com"] [["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]] [["domain","<>","logitech.com"]], "and", [["content_info.connotation_types.negative",">",1000], "or", ["content_info.text_category","has",10994]] | |
| internal_list_limit | No | maximum number of elements within internal arrays you can use this field to limit the number of elements within the following arrays | |
| keyword | Yes | target keyword Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; | |
| keyword_fields | No | target keyword fields and target keywords use this parameter to filter the dataset by keywords that certain fields should contain; you can indicate several fields; Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; example: { "snippet": "\"logitech mouse\"", "main_title": "sale" } | |
| page_type | No | target page types |