content_analysis_phrase_trends
Analyze keyword citation trends over time to identify changes in usage across specific page types and fields within a defined date range using advanced filtering options.
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 |