---
title: "List blogs"
method: GET
path: "/v1/accounts/{accountId}/blogs"
tags: ["Blogs"]
---

# List blogs

`GET /v1/accounts/{accountId}/blogs`

Lists blogs on the connected account. Shopify returns its store blogs
with cursor pagination. A WordPress account represents one site and
always returns exactly that one blog with `nextCursor: null`.

`limit` is 1-50 (default 20). Treat `nextCursor` as opaque; pass it
unchanged on the next request. Supported on Shopify (`shopify`) and
WordPress (`wordpress`).

## Path parameters

- `accountId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Blogs listed

- object
  - `platform` 'shopify' | 'wordpress'
  - `blogs` Blog[]
    - `id` string — Platform-native blog id. Shopify uses a numeric blog id. WordPress.com uses the numeric site id; self-hosted WordPress uses `1`, scoped to the connected account.
    - `platform` 'shopify' | 'wordpress'
    - `title` string
    - `handle` string — URL slug on Shopify; site hostname on WordPress.
  - `nextCursor` string, nullable — Cursor for the next page; null when there are no more pages.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — The platform rejected the request (code insufficient_permissions); reconnect the account or restore the WordPress user capabilities.
- `404` — Account not found or not accessible (code account_not_found).
- `405` — Platform does not support listing blogs.
- `429` — Rate limited by Zernio or the connected platform. Retry later.
- `502` — The connected platform returned an unclassified upstream error.

## Changes

- **2026-09-17** `fdaf9a9fb1a7` — 2 warning, 1 info
  - added the new `wordpress` enum value to the `blogs/items/platform` response property for the response status `200`
  - added the new `wordpress` enum value to the `platform` response property for the response status `200`
  - added the non-success response with the status `502`
- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `400` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `400` status
- **2026-08-14** `875093317201` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/blogs/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/339f59df69dd?raw)