---
title: "List Sites"
method: GET
path: "/sites"
tags: ["sites"]
---

# List Sites

`GET /sites`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/sites`
- Auth: API key in header `X-Agent-Key`

List the brands in the caller's active org.

The active org comes from the ``X-Org-Id`` header (web) or the ``org_id`` query
param (MCP/CLI), defaulting to the user's own org. Viewing your default org also
surfaces any legacy untagged brands (back-compat); viewing a teammate's org shows
only that org's brands.

``limit`` keeps the newest N brands. The MCP tool has declared and sent it
since it was written and this endpoint ignored it, so an agent asking for
two brands received the whole list — on the single most-called tool in the
product, on the first call of almost every session. It is applied before the
WordPress/Framer/Search-Console decoration below so the bulk lookups only
run for rows that will be returned. Default stays None (everything), because
the dashboard lists all brands and must not start truncating.

## Query parameters

- `email` string, nullable
- `org_id` string, nullable
- `limit` integer, nullable

## Headers

- `X-Org-Id` string, nullable

## Response `200`

Successful Response

- SiteOut[]
  - `id` string, required
  - `domain` string, required
  - `legacy_brand_ids` string[]
  - `logo_url` string, nullable
  - `favicon_url` string, nullable
  - `already_exists` boolean
  - `org_id` string, nullable
  - `organization_name` string, nullable
  - `owner_user_id` string, nullable
  - `owner_email` string, nullable
  - `can_admin` boolean
  - `gsc_url` string, nullable
  - `synced_queries` integer
  - `wp_connected` boolean
  - `framer_connected` boolean
  - `gsc_connected` boolean
  - `gsc_status` string, nullable
  - `shopify_connected` boolean
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)