Quickstart
Make your first request in under 5 minutes. Pick REST or MCP below.
Step 1 — Generate an API key
Open /settings in the Leto SEO app, scroll to the API keys section, and click New API key. Copy the key immediately — it starts with sk_live_ and is shown exactly once. After you leave the page it cannot be retrieved; revoke and re-generate if you lose it.
Keys are shown once. The full key is hashed with SHA-256 before storage. If you lose it, generate a new one.
Step 2 — Make your first call
Call GET https://letoseo.com/api/v1/portfolio with your key in the Authorization header. Replace sk_live_xxxx... with your actual key.
bash
curl -X GET https://letoseo.com/api/v1/portfolio \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"On success you receive a 200 with the following shape (truncated to one site):
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",
"response_format": "concise"
}
}