get_rt_project_url_serp_history
Track your domain's historical search rankings for specific keywords to monitor SEO performance over time without competitor data.
Instructions
Get ranking history showing only YOUR domain's positions across all tracked keywords. Unlike get_rt_project_keyword_serp_history (which shows full top-100), this method returns only positions where your specified domain/URL ranks. Perfect for tracking your own performance over time without competitor noise. Returns historical position data, search volumes, and optional keyword tags. This method does not consume API credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | Rank tracker project ID. Required. Get from get_rt_projects_list method. | |
| 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: 100 for most use cases (response is much smaller than get_rt_project_keyword_serp_history since it only shows your domain's positions). | |
| dateFrom | No | Start date of the period in YYYY-MM-DD format (e.g., '2025-09-01'). Filters historical data to this date range. | |
| dateTo | No | End date of the period in YYYY-MM-DD format (e.g., '2025-09-30'). Filters historical data to this date range. | |
| sort | No | Sort results by 'keyword' (alphabetically) or 'date' (chronologically). Default is 'keyword'. | |
| order | No | Sorting order: 'asc' (oldest first) or 'desc' (newest first). Default is 'desc'. | |
| keywords | No | Filter results by specific keywords (max 1000 keywords). Returns only data for the specified keywords where your domain ranks. | |
| 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. | |
| domain | No | Domain or URL to track. Accepts: 'domain.com' (tracks all URLs from this domain), 'subdomain.domain.com' (tracks specific subdomain), or full URL 'https://domain.com/page' (tracks specific page). Do NOT include protocol for domain-level tracking. |