Back to Organic competitor research

Top Organic Pages

DataForSEO

Find pages with the strongest organic keyword coverage and estimated search traffic.

Current price
$0.0168/call
Availability
Ready to run
Last accepted verification

What this API does

Returns a bounded list of relevant pages with ranking-keyword and traffic estimates for content and competitor research.

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

Public input and output shape

Input

language_namestring · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

location_namestring · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

offsetinteger · optional

Value supplied for offset.

minimum: 0 · maximum: 100000000

order_byarray · optional

Value supplied for order by.

maxItems: 3

targetstring · required

Value supplied for target.

minLength: 1 · maxLength: 2000

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

total_countnumber

Returned total count 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.top-organic-pages",
  "input": {
    "limit": 1,
    "target": "dataforseo.com",
    "language_name": "English",
    "location_name": "United States"
  }
}

Output

{
  "items": [
    {
      "metrics": {
        "organic": {
          "etv": 2518.249222220853,
          "count": 779
        }
      },
      "page_address": "https://dataforseo.com/free-seo-stats/top-1000-websites"
    }
  ],
  "items_count": 1,
  "total_count": 838
}
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","limit":1}
Updated
24 August 2026

Use Top Organic Pages with 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.