Brands Overview

curl -X GET 'https://api.snowseo.com/v3/organization/portfolio?organizationId=org_67890&start=2026-06-01&end=2026-06-30' \
  -H 'Authorization: Bearer <your_api_key>'

{
  "asOf": "2026-06-30T09:12:00.000Z",
  "isAgency": true,
  "kpis": {
    "timeSavedHours": 42.5,
    "articlesWritten": 8,
    "reports": 3,
    "activeBrands": 4
  },
  "brands": [
    {
      "teamId": "team_12345",
      "name": "Acme Marketing",
      "domain": "acme.com",
      "logoUrl": "https://assets.snowseo.com/logos/acme-logo.png",
      "status": "green",
      "aiVisibility": {
        "value": 78,
        "delta": 5,
        "sparkline": [72, 73, 75, 78]
      },
      "domainRating": 64,
      "todos": { "count": 6, "now": 2 },
      "trackedPrompts": { "count": 35, "delta": 4 },
      "trackedKeywords": { "count": 150, "delta": 12 },
      "search": {
        "clicks": 4210,
        "delta": 9,
        "sparkline": [120, 138, 145, 160]
      },
      "traffic": {
        "visits": 9800,
        "delta": -3,
        "sparkline": [300, 290, 275, 260]
      }
    }
  ]
}

GET

organization

portfolio

curl -X GET 'https://api.snowseo.com/v3/organization/portfolio?organizationId=org_67890&start=2026-06-01&end=2026-06-30' \
  -H 'Authorization: Bearer <your_api_key>'

{
  "asOf": "2026-06-30T09:12:00.000Z",
  "isAgency": true,
  "kpis": {
    "timeSavedHours": 42.5,
    "articlesWritten": 8,
    "reports": 3,
    "activeBrands": 4
  },
  "brands": [
    {
      "teamId": "team_12345",
      "name": "Acme Marketing",
      "domain": "acme.com",
      "logoUrl": "https://assets.snowseo.com/logos/acme-logo.png",
      "status": "green",
      "aiVisibility": {
        "value": 78,
        "delta": 5,
        "sparkline": [72, 73, 75, 78]
      },
      "domainRating": 64,
      "todos": { "count": 6, "now": 2 },
      "trackedPrompts": { "count": 35, "delta": 4 },
      "trackedKeywords": { "count": 150, "delta": 12 },
      "search": {
        "clicks": 4210,
        "delta": 9,
        "sparkline": [120, 138, 145, 160]
      },
      "traffic": {
        "visits": 9800,
        "delta": -3,
        "sparkline": [300, 290, 275, 260]
      }
    }
  ]
}

Retrieve the All Brands portfolio overview for one of the organizations the authenticated user belongs to. It returns a per-brand snapshot (AI visibility, domain rating, open next steps, tracked prompts/keywords, and Search/Traffic) alongside a few organization-level KPIs. The response is read from the persisted daily snapshot (brandDailyStats), so it is fast and does not trigger live provider fan-out. To force a fresh recompute, call POST /v3/organization/portfolio/refresh.

Query parameters

Parameter	Type	Description
`organizationId`	String	The organization to report on. Optional when the user belongs to a single organization; required to disambiguate when they belong to several.
`start`	String	Window start date (`YYYY-MM-DD`, UTC). Defaults to 30 days before `end`. Clamped so the window never exceeds 366 days.
`end`	String	Window end date (`YYYY-MM-DD`, UTC). Defaults to today; never in the future.

Deltas & sparklines

Point metrics (AI visibility): delta is the absolute change of the latest in-window value vs. the prior equal-length window.
Count metrics (search clicks, traffic visits): delta is the percentage change of the window sums.
Sparklines are the daily series across the selected window.

Top-level fields

Field	Type	Description
`asOf`	String (nullable)	ISO timestamp of the most recent snapshot row used; `null` when no snapshot exists yet.
`isAgency`	Boolean	Whether the organization is configured as an agency (controls the `reports` KPI).
`kpis`	Object	Organization-level totals for the window (see below).
`brands`	Array	Per-brand rows (see below).

`kpis`

Field	Type	Description
`timeSavedHours`	Number	Estimated hours saved from generated content (~1000 words ≈ 1 hour), to 1 decimal place.
`articlesWritten`	Number	Articles created in the window — the set the `timeSavedHours` estimate is derived from.
`reports`	Number (nullable)	Reports created in the window; `null` when the org is not an agency.
`activeBrands`	Number	Count of active brands the user can see in this org.

`brands[]`

Field	Type	Description
`teamId`	String	The brand/team identifier.
`name`	String	Brand display name.
`domain`	String	Brand website domain.
`logoUrl`	String (nullable)	Brand logo URL.
`status`	String	Health indicator: `green`, `amber`, or `red` (derived from AI visibility value and delta).
`aiVisibility`	Object	`{ value, delta, sparkline[] }` — latest AI visibility score, absolute change, and daily series.
`domainRating`	Number (nullable)	Ahrefs Domain Rating for the brand’s root domain; `null` when not yet fetched.
`todos`	Object	`{ count, now }` — open next steps, and how many are priority `now`.
`trackedPrompts`	Object	`{ count, delta }` — enabled tracked prompts, and how many were added in the window.
`trackedKeywords`	Object	`{ count, delta }` — active tracked keywords, and how many were added in the window.
`search`	Object (nullable)	`{ clicks, delta, sparkline[] }` from Search Console; `null` when Search Console isn’t connected.
`traffic`	Object (nullable)	`{ visits, delta, sparkline[] }` from analytics; `null` when analytics isn’t connected.

Metrics come from the persisted daily snapshot. If a brand has no data yet for the window (no audit, no AI visibility runs, or a disconnected integration), the relevant metric returns null (search, traffic, domainRating) or 0 (counts), and sparklines return empty or partial series.

Omit organizationId for single-org users. For multi-org users, resolve the organization from any of your teams first (each team carries its organizationId).

curl -X GET 'https://api.snowseo.com/v3/organization/portfolio?organizationId=org_67890&start=2026-06-01&end=2026-06-30' \
  -H 'Authorization: Bearer <your_api_key>'

{
  "asOf": "2026-06-30T09:12:00.000Z",
  "isAgency": true,
  "kpis": {
    "timeSavedHours": 42.5,
    "articlesWritten": 8,
    "reports": 3,
    "activeBrands": 4
  },
  "brands": [
    {
      "teamId": "team_12345",
      "name": "Acme Marketing",
      "domain": "acme.com",
      "logoUrl": "https://assets.snowseo.com/logos/acme-logo.png",
      "status": "green",
      "aiVisibility": {
        "value": 78,
        "delta": 5,
        "sparkline": [72, 73, 75, 78]
      },
      "domainRating": 64,
      "todos": { "count": 6, "now": 2 },
      "trackedPrompts": { "count": 35, "delta": 4 },
      "trackedKeywords": { "count": 150, "delta": 12 },
      "search": {
        "clicks": 4210,
        "delta": 9,
        "sparkline": [120, 138, 145, 160]
      },
      "traffic": {
        "visits": 9800,
        "delta": -3,
        "sparkline": [300, 290, 275, 260]
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

organizationId

string

Organization ID (from list_teams). Optional when the user belongs to a single org.

start

string

Window start date (YYYY-MM-DD, UTC). Defaults to 30 days before end.

end

string

Window end date (YYYY-MM-DD, UTC). Defaults to today.

Response

200

Default Response

Overview

Website Analysis

Keywords & Research

Topic Clusters

Traffic & Analytics

AI Visibility

Rank Tracking

Article Generation

Content

Content Utilities

Reports

Dashboard

Settings

Brands Overview

Query parameters

Deltas & sparklines

Top-level fields

`kpis`

`brands[]`

Authorizations

Query Parameters

Response

​Query parameters

​Deltas & sparklines

​Top-level fields

​kpis

​brands[]

Authorizations

Query Parameters

Response

Query parameters

Deltas & sparklines

Top-level fields

`kpis`

`brands[]`