REST

Sites

Returns a paginated list of your sites with basic metadata. Use cursor-based pagination to page through large portfolios.

GET/api/v1/sites

List all sites

Returns a paginated list of your sites with basic metadata. Use the cursor-based pagination params to page through results.

Paginated — supports cursor and limit

Request

bash

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

Query parameters

Name	Type	Required	Description	Default
`cursor`	`string`	optional	Opaque pagination cursor returned in the previous response as next_cursor. Omit to start from the beginning.	—
`limit`	`integer`	optional	Number of items per page. Min 1, max 100.	`25`

Responses

200Paginated list of sites.

json

{
  "data": {
    "items": [
      {
        "id": "00000000-0000-0000-0000-000000000001",
        "name": "Acme Demo Co",
        "url": "https://acme-demo.example",
        "maturity": "established",
        "health_score": 72,
        "organic_sessions_30d": 3850,
        "favicon_url": null,
        "tags": [],
        "created_at": "2024-11-01T12:00:00.000Z"
      }
    ],
    "total_count": 1
  },
  "_meta": {
    "generated_at": "2025-01-15T10:30:00.000Z"
  }
}