API Reference
Dataset catalog & freshness
Public catalog of every dataset Clous serves, with row counts and freshness.
Dataset catalog & freshness
Public catalog of every dataset Clous serves, with row counts and freshness.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
GET /v1/sourcesResults are returned through the standard response envelope and are cursor-paginated.
Example request
curl -s "https://api.clous.ai/v1/sources?limit=3" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/sources",
params={"limit":"3"},
headers={"Authorization": "Bearer clous_live_..."},
)
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/sources?limit=3",
{ headers: { Authorization: "Bearer clous_live_..." } },
);
const data = await resp.json();Example response
{
"sources": [
{
"dataset": "filings",
"endpoint": "/v1/filings",
"records": 21860825,
"last_synced": "2026-06-13T06:30:07",
"status": "snapshot"
},
{
"dataset": "13F holdings",
"endpoint": "/v1/holdings",
"records": 17958280,
"last_synced": "2026-06-13T06:30:07",
"status": "snapshot"
}
],
"count": 27,
"as_of": "2026-06-13T16:27:35.845632Z",
"note": "All data derived from public SEC EDGAR filings. Clous is independent of the SEC."
}Status codes
| Status | Meaning |
|---|---|
200 | Success. An empty result still returns 200 with data: [] and a warnings entry. |
401 | Missing or invalid API key. |
402 | Out of credits. |
404 | No record for the supplied path parameter. |
422 | Validation error — a parameter was the wrong type or out of range. |
429 | Rate limited. |
All data derives from public SEC EDGAR (and, where noted, FINRA IAPD / USPTO) filings. Clous is independent of the SEC.