Sites
List the sites on your account and read one site's full profile, content settings, and article usage.
Sites are the unit everything else hangs off — keywords, articles, and Search Console data are all per-site. Get site ids here first.
List sites
GET /api/v1/sites{
"data": [
{
"id": "0d3f1c9a-…",
"url": "https://yoursite.com",
"name": "Your Site",
"niche": "developer tools",
"language": "en",
"additional_languages": ["de", "es"],
"geo": "global",
"country_code": null,
"autopilot": true,
"is_active": true,
"created_at": "2026-05-02T09:12:00.000Z"
}
]
}is_active tells you whether the site has a live subscription — generation
endpoints refuse inactive sites.
Get a site
GET /api/v1/sites/{site_id}Everything from the list item, plus the site's brief and this billing period's article usage:
{
"id": "0d3f1c9a-…",
"url": "https://yoursite.com",
"name": "Your Site",
"description": "What the site/product does — the brief behind every article.",
"positioning": "How it's differentiated.",
"niche": "developer tools",
"blog_url": "https://yoursite.com/blog",
"tone": "professional",
"content_length": "balanced",
"monthly_keyword_limit": 50,
"usage": {
"articles_allowed": 30,
"articles_used": 12,
"period_start": "2026-07-01T00:00:00.000Z",
"period_end": "2026-08-01T00:00:00.000Z"
}
}additional_languages (from the list item above) does not affect usage:
every article is also published in each of those languages, but those versions are
covered by a paid add-on rather than metered — one articles/generate call always
costs one of articles_allowed. See Languages.
Site settings (name, description, tone, languages, …) are editable in the dashboard, not over the API — they steer the content engine, so changes deserve human eyes.