> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Which pages bring a domain search traffic?

> Call POST /v1/seo/top-pages with domain, country, and language to rank a site's URLs by search_traffic_estimate, keeping organic search estimates separate from total site visits.

Send `domain`, `country`, and `language` to `POST /v1/seo/top-pages` to list a site's pages ranked from highest to lowest `search_traffic_estimate` in the target market.

## Query top-performing URLs

Use a modest `limit` (`1–1000`, default `100`) and `offset` (`0–10000`) to inspect the leading pages without paying for unnecessary rows.

```bash
curl -sS https://api.beatapi.io/v1/seo/top-pages \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com","country":"us","language":"en","limit":20}'
```

Each row in `results` includes `url`, `ranking_keywords`, `search_traffic_estimate`, `traffic_value_usd_estimate`, `rank_distribution`, and recent movement counts (`new`, `up`, `down`, `lost`).

## Interpret estimates accurately

* **Prioritize page reviews**: Shortlist candidate URLs (such as descaling or troubleshooting guides for a maintenance section) by `results[].url` and `search_traffic_estimate`, then read each live page to see which problems the content solves.
* **Separate metric definitions**: Store `search_traffic_estimate` in a dedicated column labeled as an organic search estimate. Do not equate `search_traffic_estimate` with total site visits (`site_visits_estimate` from `POST /v1/seo/site-traffic`), unique visitors, or conversions, which require separate data sources.

## Contracts and related questions

Before sending a paid request, inspect the SEO contracts for free: `data:seo.keyword_overview`, `data:seo.ranked_keywords`, `data:seo.top_pages`, `data:seo.backlinks`.

[Back to SEO questions](/faq/seo).