get_rt_project_keyword_serp_history
Retrieve historical Google SERP data for tracked keywords to analyze competitor positions, search volumes, and ranking trends over time.
Instructions
Get complete Google top-100 SERP history for tracked keywords in a rank tracker project. Returns full competitor analysis with historical positions, URLs, domains, and search volumes for each date. WARNING: This method returns large datasets (full top-100 for each keyword/date combination). Recommended pageSize: 20-50 for most use cases. Use date filters and keyword filters to reduce response size. Supports keyword tagging for grouping and filtering. This method does not consume API credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | Project identifier | |
| projectRegionId | Yes | Region ID for the project. Required. Get from get_rt_project_regions_list method. Each project can track multiple regions. See region reference: https://docs.google.com/spreadsheets/d/1LUDtm-L1qWMVpmWuN-nvDyYFfQtfiXUh5LIHE8sjs0k/edit?gid=75443986#gid=75443986 | |
| page | Yes | Page number for pagination. Starts at 1. | |
| pageSize | No | Number of keywords per page. Allowed values: 20, 50, 100, 500. RECOMMENDED: Use 20 or 50 to avoid response truncation due to large dataset sizes. Each keyword returns full top-100 SERP for all dates. | |
| dateFrom | No | Start date of the period in YYYY-MM-DD format (e.g., '2025-09-01'). Use to filter historical data and reduce response size. | |
| dateTo | No | End date of the period in YYYY-MM-DD format (e.g., '2025-09-30'). Use to filter historical data and reduce response size. | |
| sort | No | Sort results by 'keyword' (alphabetically) or 'date' (chronologically). Default is 'date'. | |
| order | No | Sorting order: 'asc' (oldest first) or 'desc' (newest first). Default is 'desc'. | |
| keywords | No | Filter by specific keywords (max 1000 keywords) | |
| withTags | No | Include keyword tags in the response. Tags are used to group and categorize keywords in the project. Set to true to receive tag IDs and values for each keyword. |