# Organic Traffic History

DataForSEO

Track estimated organic keyword coverage and search traffic over time.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Organic Traffic History (tool ID: dataforseo.organic-traffic-history). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Research SEO competitors](https://scrollport.com/tools/website-traffic-api)

**Current price:** $0.1680/request

**Availability:** Ready to run

## Tool details

**About this tool**

Returns historical DataForSEO Labs rank-overview snapshots for trend and impact analysis without presenting estimates as first-party analytics.

**Inputs and outputs**

### Input

`date_from` string · required

Value supplied for date from.

format: date

`date_to` string · required

Value supplied for date to.

format: date

`language_name` string · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

`location_name` string · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

`target` string · required

Value supplied for target.

minLength: 1 · maxLength: 2000

### Output

`items` array

Returned items value.

`items_count` number

Returned items count value.

`target` string

Returned target value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "dataforseo.organic-traffic-history",
  "input": {
    "target": "dataforseo.com",
    "date_to": "2026-08-01",
    "date_from": "2026-05-01",
    "language_name": "English",
    "location_name": "United States"
  }
}
```

### Output

```
{
  "items": [
    {
      "year": 2026,
      "month": 8,
      "metrics": {
        "organic": {
          "etv": 9108.61860274896,
          "count": 3133,
          "is_up": 901,
          "is_new": 1537,
          "is_down": 561
        }
      }
    }
  ],
  "target": "dataforseo.com",
  "items_count": 4
}
```

**Errors and limitations**

- `configuration_error`: DataForSEO account access, funding or cost controls blocked the request.Verify and fund the server-side DataForSEO API-access credentials, then retry unchanged.
- `invalid_input`: DataForSEO rejected a target, location or bounded result control.example: {"target":"dataforseo.com","location_name":"United States","language_name":"English","date_from":"2026-05-01","date_to":"2026-08-01"}

---

Canonical page: https://scrollport.com/tools/providers/dataforseo/organic-traffic-history