get-phrase-trendsstarterCompetitors & Domain IntelligenceGet Phrase Trends Tool
Get phrase mention trends over time for a keyword. Returns citation data grouped by day, week, or month for the specified date range, showing how keyword mentions change over time.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| keyword | string | required | The keyword or phrase to track trends for. Use double quotes with backslashes for exact phrase matching. |
| date_from | string | required | Start date for the trend period in YYYY-MM-DD format. |
| date_to | string | optional | End date for the trend period in YYYY-MM-DD format. Defaults to today. |
| date_group | string | optional | How to group the trend data: day, week, or month. Defaults to month. |
| page_type | array | optional | Filter by page type: ecommerce, news, blogs, message-boards, organization. |
| internal_list_limit | integer | optional | Maximum number of elements within internal arrays (1-20). Defaults to 1. |
Plan access
Available on the starter tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).
See plans