Haloscan icon

Haloscan

Haloscan is a powerful SEO analysis tool that provides insights into keyword rankings, domain metrics, and related searches.

Overview

This node operation fetches historical SEO metrics for specific pages of a given domain or URL within a specified date range. It is useful for SEO analysts and digital marketers who want to track the performance and changes of domain pages over time, such as traffic, keyword rankings, and visibility trends. For example, it can be used to analyze how a website's pages have evolved in search engine rankings or to monitor the impact of SEO campaigns on page performance.

Use Case Examples

  1. Track the historical traffic and keyword rankings of a domain's pages from January 1, 2023, to March 31, 2023.
  2. Compare the SEO performance of a domain's pages over different time periods to identify trends and opportunities for optimization.

Properties

Name Meaning
Input The requested URL or domain to fetch the history for.
Date From The start date (YYYY-MM-DD) for the historical data range.
Date To The end date (YYYY-MM-DD) for the historical data range.
Page The page number of the results to retrieve (pagination).
Line Count The maximum number of results to return.
Mode Determines whether to look for a domain, root domain, URL, or auto-detect.
Order By Field used for sorting the results, such as traffic, position, or URL.
Additional Fields Optional filters and limits for the results, such as maximum or minimum values for known versions, traffic, and keyword counts, as well as the order direction (ascending or descending).

Output

JSON

  • date_from - Start date of the historical data range.
  • date_to - End date of the historical data range.
  • input - The requested URL or domain.
  • page - Current page number of the results.
  • lineCount - Maximum number of results returned.
  • mode - Mode of input detection (auto, domain, root, URL).
  • order_by_pagehistory - Field used for sorting the results.
  • additionalFields - Additional filters applied to the query.
  • results - Array of historical metrics for domain pages, including traffic, keyword rankings, visibility, and other SEO-related data.

Dependencies

  • An API key credential for Haloscan API

Troubleshooting

  • Ensure the 'Input' field is a valid URL or domain to avoid request errors.
  • Verify that 'Date From' and 'Date To' are in the correct YYYY-MM-DD format and that 'Date From' is not after 'Date To'.
  • Check API key credentials and permissions if authentication errors occur.
  • If no results are returned, try adjusting filters or increasing the 'Line Count' and 'Page' parameters.
  • Network issues or SSL certificate problems can be mitigated by enabling the 'Ignore SSL Issues' option or configuring a proxy if needed.

Links

Discussion