Actions51
- AI Visibility Actions
- Analytics Actions
- Backlink Actions
- Content Actions
- Keyword Actions
- Utility Actions
Analytics → Website: Referrers
AI-generatedSummary
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
datafield; errors may include anerrorobject 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