{"input_schema":{"type":"object","properties":{"keywords":{"type":"array","description":"Keywords. Required if you don't specify category_code the maximum number of keywords.","examples":[["rugby","cricket"]]},"location_code":{"type":"integer","description":"Search engine location code. Optional. if you don't use this field, you will recieve global results."},"language_code":{"type":"string","description":"Search engine language code. Optional. default value: en."},"category_code":{"type":"integer","description":"Google trends search category. Required if you don't specify keywords if you don't specify keywords, the value of this field must be greater than 0 if you specify keywords and don't specify this field, the 0 value will be applied by default and the search will be carried out across all available categories.","examples":[3]},"location_name":{"type":"string","description":"Which market to report on; omit for worldwide interest.","examples":["United States"]},"type":{"type":"string","description":"Which search property to draw the trend from.","enum":["web","news","youtube","images","froogle"],"default":"web"},"time_range":{"type":"string","description":"A preset window, ignored when explicit dates are given.","examples":["past_12_months"]},"date_from":{"type":"string","description":"Start of the range, as `YYYY-MM-DD`.","examples":["2026-01-01"]},"date_to":{"type":"string","description":"End of the range, as `YYYY-MM-DD`.","examples":["2026-09-01"]},"item_types":{"type":"array","description":"Which blocks to return: the graph, the map, topics, or queries.","examples":[["google_trends_graph"]]}},"required":[],"additionalProperties":true,"examples":[{"category_code":3,"keywords":["rugby","cricket"]}]},"output_schema":{"type":"object","description":"A time series of relative interest per term, with averages, and any regional, topic, or query blocks requested.","additionalProperties":true},"addons_schema":{"type":"object","additionalProperties":false},"capability_id":"dataforseo.keyword-data","session_compatible":true,"pricing_available":true,"id":"dataforseo/keywords_google_trends_explore_live","object":"endpoint","provider":"dataforseo","endpoint":"keywords_google_trends_explore_live","name":"Search interest over time","summary":"Compare relative search interest for up to five terms.","description":"Reports how search interest in a set of terms has moved over time, as a relative popularity index rather than absolute counts. Up to five terms can be compared in one call, returning a value at each interval in the chosen range with explicit markers where data is missing, plus averages across the period. A geographic breakdown shows which regions searched most for each term, and related topic and query lists reveal what people search alongside them. The trend can be drawn from web, news, video, image, or shopping search, which gives materially different pictures for the same term.","unit":"call","price_per_unit":null,"list_price_per_unit":"0.075","reports_cost":true,"input_fields":[{"name":"keywords","type":"array","required":false,"description":"Keywords. Required if you don't specify category_code the maximum number of keywords.","example":["rugby","cricket"]},{"name":"location_code","type":"integer","required":false,"description":"Search engine location code. Optional. if you don't use this field, you will recieve global results."},{"name":"language_code","type":"string","required":false,"description":"Search engine language code. Optional. default value: en."},{"name":"category_code","type":"integer","required":false,"description":"Google trends search category. Required if you don't specify keywords if you don't specify keywords, the value of this field must be greater than 0 if you specify keywords and don't specify this field, the 0 value will be applied by default and the search will be carried out across all available categories.","example":3},{"name":"location_name","type":"string","required":false,"description":"Which market to report on; omit for worldwide interest.","example":"United States"},{"name":"type","type":"string","required":false,"description":"Which search property to draw the trend from.","default":"web","enum_values":["web","news","youtube","images","froogle"]},{"name":"time_range","type":"string","required":false,"description":"A preset window, ignored when explicit dates are given.","example":"past_12_months"},{"name":"date_from","type":"string","required":false,"description":"Start of the range, as `YYYY-MM-DD`.","example":"2026-01-01"},{"name":"date_to","type":"string","required":false,"description":"End of the range, as `YYYY-MM-DD`.","example":"2026-09-01"},{"name":"item_types","type":"array","required":false,"description":"Which blocks to return: the graph, the map, topics, or queries.","example":["google_trends_graph"]}],"example_request":{"provider":"dataforseo","endpoint":"keywords_google_trends_explore_live","input":{"category_code":3,"keywords":["rugby","cricket"]}},"output":"A time series of relative interest per term, with averages, and any regional, topic, or query blocks requested.","limits":{"request_bytes":1000000,"timeout_ms":180000,"input_characters":null,"audio_bytes":null}}