Keupera icon

Keupera

Automate your SEO, AEO and GEO with Keupera.

Analytics → Website: Referrers

AI-generated

Summary

Fetch website referrers for a selected date range and optional filters, returning referrer data.

Inputs

  • websiteId — Leave empty to use the website your API key is bound to; set to override and target a different website you own.
  • range — Select a predefined date range (7d, 30d (default), 90d) or "custom" for a custom range.
  • fromDate — Start date (YYYY‑MM‑DD) used only when Date Range is set to Custom.
  • toDate — End date (YYYY‑MM‑DD) used only when Date Range is set to Custom.
  • limit — Maximum number of results to return; must be between 1 and 500, default 50.
  • allowUnauthorizedCerts — Whether to accept the response even if SSL certificate validation fails.
  • proxy — HTTP proxy to use; format e.g. http://username:password@myproxy:3128.
  • timeout — Time in milliseconds to wait for the server to send response headers before aborting the request.

Output shape

list of referrer objects

The response body is returned in the data field; errors may include an error object and do not follow a fixed schema.

Examples

Example 1: Fetch top referrers for the default website over the last 30 days, limited to 10 results

websiteId empty, range 30d, limit 10

Example 2: Custom date range from January 1 to January 31, requesting 5 results

range custom, fromDate 2024-01-01, toDate 2024-01-31, limit 5

Example 3: Batch request with 20 items per batch using default proxy

limit 20, requestOptions batching batchSize 20, batchInterval 1000

Links

Discussion