Serpstat icon

Serpstat

Search marketing and AI data with Serpstat API

Actions85

Domain → Get Domain Search History

AI-generated

Overview

This node operation fetches the search history data for a specified domain using the Serpstat API. It retrieves historical changes related to keywords, visibility, traffic, and other domain metrics over time. This is useful for SEO analysts and marketers who want to track the performance and trends of a domain's search presence historically.

Use Case Examples

  1. Track the historical keyword rankings and visibility changes of a competitor's domain to analyze their SEO strategy over time.
  2. Monitor your own domain's search traffic and keyword history to evaluate the impact of recent SEO campaigns or website changes.

Properties

Name Meaning
Domain The domain name to query for search history data.
Search Engine The search engine database to use for the query (e.g., g_us for Google US).
Filters Optional filters to refine the search history data, such as date range, traffic, and visibility filters.
Additional Fields Additional optional parameters like 'during all time' to specify the time range and 'with subdomains' to include subdomain data in the response.

Output

JSON

  • date - The date of the historical record.
  • keywords - Number of keywords the domain ranked for on that date.
  • traffic - Estimated traffic for the domain on that date.
  • visibility - Visibility score of the domain on that date.
  • ad_keywords - Number of paid keywords on that date.
  • ads - Number of ads on that date.
  • aio_citations - AI Overview citations count on that date.
  • aio_keywords - AI Overview keywords count on that date.
  • down_keywords - Number of keywords that dropped in ranking on that date.
  • new_keywords - Number of new keywords gained on that date.
  • out_keywords - Number of keywords lost on that date.
  • rised_keywords - Number of keywords that rose in ranking on that date.
  • visible_static - Static visibility metric on that date.

Dependencies

  • Serpstat API key credential

Troubleshooting

  • Ensure the domain parameter is correctly set and valid.
  • Check that the search engine parameter is supported and correctly selected.
  • Verify that date filters (date_from, date_to) are in the correct format (YYYY-MM-DD).
  • Handle API errors by checking the error message returned from Serpstat and adjusting parameters accordingly.
  • If no data is returned, confirm that the domain has historical data available in Serpstat for the selected search engine and filters.

Discussion