REST

Pages

Returns the top pages for a site ordered by organic sessions or impressions, with CWV status and index status per page.

GET/api/v1/sites/:siteId/pages

Top pages

Returns the top pages for a site ordered by organic sessions or impressions, with CWV status and index status per page.

Request

bash

curl -X GET \
  'https://letoseo.com/api/v1/sites/:siteId/pages' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

Path parameters

Name	Type	Required	Description	Default
`siteId`	`uuid`	required	The site UUID.	—

Query parameters

Name	Type	Required	Description	Default
`limit`	`integer`	optional	Maximum number of pages to return. Max 100.	`25`
`sort_by`	`"sessions" \| "impressions"`	optional	Column to sort results by.	`sessions`

Responses

200List of top pages.

json

{
  "data": [
    {
      "url": "https://acme-demo.example/blog/example-post",
      "title": "Example Post — Acme Marketing Blog",
      "organic_sessions_30d": 185,
      "impressions_30d": 4200,
      "clicks_30d": 210,
      "ctr": 0.05,
      "avg_position": 8.3,
      "cwv_status": "pass",
      "index_status": "indexed"
    },
    {
      "url": "https://acme-demo.example/tools/example-tool",
      "title": "Example Tool — Acme Demo Co",
      "organic_sessions_30d": 97,
      "impressions_30d": 2800,
      "clicks_30d": 84,
      "ctr": 0.03,
      "avg_position": 12.1,
      "cwv_status": "fail",
      "index_status": "indexed"
    }
  ],
  "_meta": {
    "generated_at": "2025-01-15T10:30:00.000Z",
    "site_id": "00000000-0000-0000-0000-000000000001"
  }
}

404Site not found.

json

{
  "error": "Site not found"
}