Organic Traffic History

DataForSEO

Track estimated organic keyword coverage and search traffic over time.

Capability: Organic competitor research
Current price: $0.1680/call
Availability: Ready to run

What this API does

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

Agents select this operation with tool ID dataforseo.organic-traffic-history, then inspect its current executable contract before a run.

Public input and output shape

Input

date_fromstring · required

Value supplied for date from.

format: date

date_tostring · required

Value supplied for date to.

format: date

language_namestring · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

location_namestring · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

targetstring · required

Value supplied for target.

minLength: 1 · maxLength: 2000

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

targetstring

Returned target value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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
}

Teaching 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"}

Use Organic Traffic History with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.