Actions30
- AI Optimization Actions
- Backlink Actions
- Business Data Actions
- Keywords Data Actions
- Labs Actions
- On Page Actions
- SERP Actions
Labs → Get Historical Traffic Stats
AI-generatedSummary
Retrieve a historical estimate of organic search traffic for one or more specified domains or subdomains within a particular location and language context.
Inputs
- Target Domains or Subdomains (required) — One or more domains or subdomains specified without https:// and www. for which to retrieve historical traffic stats.
- Location (required) — The full name of the location to use for the traffic data (e.g., a country or region).
- Language (required) — The full name of the language context to use for the traffic data.
- Item Types — The types of search results to include in the response, such as organic, paid, featured snippet, or local pack.
Output shape
a JSON object containing historical organic traffic estimates per specified target domain or subdomain, location, and language, including data filtered by the specified item types.
The operation accepts multiple target domains or subdomains in one request. Item Types is optional; if unspecified, the response may contain all types. The location and language parameters are required and must correspond to supported DataForSEO location and language names as documented. The output reflects a historical bulk traffic estimation. Results are returned as an array within the JSON response's 'tasks' section under 'dataforseo_labs/google/historical_bulk_traffic_estimation/live' endpoint. No pagination parameters are specified for this operation.