Top Organic Pages

Ahrefs

Find leading organic-search pages, traffic estimates and top keywords.

Capability: Organic competitor research
Current price: $0.9660/request
Availability: Ready to run

What this API does

Find a domain's leading organic-search pages, traffic estimates and top keywords. Request one to ten slots. The catalog shows the ten-slot maximum; the input quote scales to the requested limit. Every completed request, including an empty result, costs its quote. Failed requests are uncharged. The worked example shows selected recorded fields and at most one item per list; counts retain their recorded values.

Agents select this operation with tool ID ahrefs.top-pages, then check its current inputs and price before a run.

Inputs and outputs

Input

countrystring · optional

Value supplied for country.

minLength: 1 · maxLength: 2

datestring · required

Value supplied for date.

minLength: 1 · maxLength: 10

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 10

targetstring · required

Value supplied for target.

minLength: 1 · maxLength: 253

Output

datestring

Returned date value.

pagesarray

Returned pages value.

returned_resultsnumber

Returned returned results value.

targetstring

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": "ahrefs.top-pages",
  "input": {
    "date": "2026-09-13",
    "limit": 1,
    "target": "cloudflare.com",
    "country": "us"
  }
}

Output

{
  "date": "2026-09-13",
  "pages": [
    {
      "url": "https://www.cloudflare.com/learning/cdn/what-is-a-cdn/",
      "top_keyword": "cdn service",
      "top_keyword_volume": 3310000,
      "estimated_organic_traffic": 484856,
      "top_keyword_best_position": 2
    }
  ],
  "target": "cloudflare.com",
  "returned_results": 1
}

Errors and limitations

upstream_error: The provider could not return usable results; the wallet was not charged.Check the query and input limits, or use another tool.

Use Top Organic Pages with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.