---
title: "All published guides with full body (the build payload)."
method: GET
path: "/api/v1/marketing/guides"
tags: ["Marketing"]
---

# All published guides with full body (the build payload).

`GET /api/v1/marketing/guides`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/marketing/guides`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>With include_drafts=1 the response gains a second `drafts` array:<br/>each draft's full payload PLUS its previewToken. Design note: draft<br/>bodies become publicly fetchable through this param BY DESIGN. The<br/>pages they feed are public-at-unguessable-URL noindexed previews<br/>(Lior approved 2026-07-04); nothing enumerable links them, so a draft<br/>is only reachable by someone already holding its unguessable token.<br/>Drafts are never mixed into the published `guides` array.

## Query parameters

- `include_drafts` integer

## Response `200`

OK

- GuidePublicListResponse
  - `drafts` PublicDraftItem[]
    - `author` string, required
    - `bodyMarkdown` string, required
    - `canonicalTo` string, nullable
    - `description` string, required
    - `faqs` GuideFaq[], required
      - `a` string, required
      - `q` string, required
    - `featured` boolean, required
    - `headline` string, required
    - `heroAlt` string, required
    - `heroImage` string, required
    - `noindex` boolean, required
    - `ogImage` string, required
    - `pillar` string, required
    - `popularRank` integer, nullable
    - `previewToken` string, nullable
    - `publishDate` string, date, required
    - `quotableAnswer` string, required
    - `related` string[], required
    - `section` string, required
    - `slug` string, required
    - `stat` string, required
    - `title` string, required
    - `updatedDate` string, date, required
  - `guides` GuidePublicItem[], required
    - `author` string, required
    - `bodyMarkdown` string, required
    - `canonicalTo` string, nullable
    - `description` string, required
    - `faqs` GuideFaq[], required
      - `a` string, required
      - `q` string, required
    - `featured` boolean, required
    - `headline` string, required
    - `heroAlt` string, required
    - `heroImage` string, required
    - `noindex` boolean, required
    - `ogImage` string, required
    - `pillar` string, required
    - `popularRank` integer, nullable
    - `publishDate` string, date, required
    - `quotableAnswer` string, required
    - `related` string[], required
    - `section` string, required
    - `slug` string, required
    - `stat` string, required
    - `title` string, required
    - `updatedDate` string, date, required

## Other responses

- `422`: Unprocessable Entity

---

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