Serpstat icon

Serpstat

Search marketing and AI data with Serpstat API

Actions85

Rank Tracker → Get Rank Tracker Keyword SERP History

AI-generated

Overview

This node operation fetches the historical search engine results page (SERP) data for keywords tracked in a specific rank tracker project and region. It is useful for monitoring how keyword rankings have changed over time within a project, allowing users to analyze SEO performance and trends. For example, a user can retrieve the top 100 Google search results for selected keywords in a given region and project to understand ranking fluctuations and competitor positions.

Use Case Examples

  1. Retrieve the SERP history for keywords in a rank tracker project for the US region to analyze ranking changes over the past month.
  2. Get the keyword SERP history for a specific project and region with filters such as date range, sorting order, and pagination to generate reports on keyword performance.

Properties

Name Meaning
Project ID The numeric identifier of the rank tracker project for which keyword SERP history is requested.
Region ID The numeric identifier of the search region for which the keyword SERP history is requested.
Additional Fields Optional parameters to refine the query such as date range (Date From, Date To), keywords list, sorting order, pagination (Page, Page Size), and whether to display tags for keywords.

Output

JSON

  • json - The JSON object containing the keyword SERP history data for the specified project and region.

Dependencies

  • Serpstat API with an API key credential

Troubleshooting

  • Ensure the Project ID and Region ID are correctly specified and valid numeric values.
  • Verify that the API key credential for Serpstat is correctly configured and has the necessary permissions.
  • Check the date format for 'Date From' and 'Date To' fields to be in YYYY-MM-DD format.
  • If the API response does not contain expected data, verify that the project and region have tracked keywords and data available for the requested period.
  • Handle API errors gracefully by checking error messages returned from the Serpstat API and adjusting parameters accordingly.

Links

Discussion