REST

Portfolio

Returns health scores, organic traffic trends, and active alert counts for every site in your portfolio.

GET/api/v1/portfolio

Portfolio health summary

Returns health scores, organic traffic trends, and active alert counts for every site in your portfolio.

Request

bash

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

Query parameters

Name	Type	Required	Description	Default
`sort_by`	`"health_score" \| "name" \| "traffic"`	optional	Sort order for the returned sites. Defaults to creation date descending.	—
`filter_maturity`	`"early" \| "established"`	optional	Filter sites by maturity stage. "early" means fewer than 100 organic sessions/month; "established" means 100 or more.	—

Responses

200List of portfolio sites with health data.

json

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "name": "Acme Demo Co",
      "url": "https://acme-demo.example",
      "faviconUrl": null,
      "healthScore": 72,
      "maturity": "established",
      "sparklineData": [
        {
          "date": "2025-01-08",
          "value": 1240
        },
        {
          "date": "2025-01-09",
          "value": 1310
        }
      ],
      "trendDirection": "up",
      "activeAlertCount": 1,
      "tags": [],
      "organicSessions30d": 3850,
      "impressions30d": 18400
    }
  ],
  "_meta": {
    "generated_at": "2025-01-15T10:30:00.000Z"
  }
}