Serpstat icon

Serpstat

Search marketing and AI data with Serpstat API

Actions85

Rank Tracker → Get Rank Tracker Top Competitors History

AI-generated

Overview

This node operation fetches the historical data of top competitors' domains for a specified project and region within the Rank Tracker resource. It is useful for tracking the competitive landscape over time by analyzing which domains have appeared in the top-20 search results for any two project keywords in a given region. For example, a digital marketer can use this to monitor competitors' ranking trends and adjust SEO strategies accordingly.

Use Case Examples

  1. Retrieve the top competitors' ranking history for a specific project and region to analyze market competition trends.
  2. Track changes in competitor domains appearing in top search results over a defined date range.

Properties

Name Meaning
Project ID The numeric identifier of the project for which the top competitors history is requested.
Region ID The numeric identifier of the search region for which the data is requested.
Additional Fields Optional parameters to refine the query such as date range, domains list, keywords list, sorting order, pagination, and whether to include tags for keywords.

Output

JSON

  • json - The JSON object containing the top competitors history data returned from the Serpstat API.

Dependencies

  • Serpstat API key credential

Troubleshooting

  • Ensure the Project ID and Region ID are correctly specified and valid numeric values.
  • Verify that the Serpstat API key credential 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 data, verify the project and region have relevant ranking history data available.

Links

Discussion