# Markdown publishing — markdown.page (Featured Quarter Plan)

> Markdown publishing — markdown.page (Featured Quarter Plan) is a paid API for AI agents from markdown.page, paid per call via x402, $79/call, status unknown (last checked 2026-09-14).

Purchases a 90-day featured listing slot on markdown.page for an existing page at a specified featured slug, requiring post-payment editorial approval.

## Facts

- Endpoint: POST https://markdown.page/api/featured/purchase/quarter
- Price: $79/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/markdown-publishing-markdown-page-featured-quarter-plan-1f4a8124
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yuze-k0vfulDwNw-oTK7I

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability markdown-publishing-markdown-page-featured-quarter-plan-1f4a8124 -d '<json body>'
```

Example prompt: Can you purchase the quarterly 90-day featured listing on markdown.page for my page with ID 'my-blog-post-123' and feature it under the slug 'best-ai-tools'?

## When to prefer this

Use this endpoint when you want to pay for a 90-day promotional featured listing for an existing markdown.page page. Choose this over shorter plans if the user wants maximum sustained visibility. This is specifically for markdown.page's featured placement product and requires an existing published page on the platform, not for initial page creation or one-time publishing.

## Known failure modes

- Invalid pageId — page does not exist on markdown.page
- featuredSlug does not match required lowercase alphanumeric pattern
- Payment failure via x402 protocol
- Duplicate requestId — idempotency key already used
- articleUrl is malformed or not a valid markdown.page URL
- Featured slug already taken by another page
- Approval rejected after payment — listing does not go live despite successful payment

## How this service works

Publish Markdown to a public URL. Browsers receive HTML; command-line tools and agents receive plain text. No account or API key required.

## Output

Returns a JSON object confirming payment via x402, with a unique listing ID, the plan name ('quarter'), page ID, featured slug, duration of 90 days, current status ('paid_pending_review'), and a flag indicating that editorial approval is required before the listing goes live.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "pageId",
      "featuredSlug"
     ],
     "properties": {
      "pageId": {
       "type": "string",
       "description": "ID of an existing markdown.page page."
      },
      "contact": {
       "type": "string"
      },
      "requestId": {
       "type": "string",
       "pattern": "^[A-Za-z0-9_.:-]{8,128}$"
      },
      "articleUrl": {
       "type": "string",
       "format": "uri",
       "description": "Public markdown.page URL for an existing page."
      },
      "featuredSlug": {
       "type": "string",
       "pattern": "^[a-z0-9-]+$"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "id",
      "provider",
      "status",
      "pageId",
      "featuredSlug",
      "plan",
      "durationDays",
      "approvalRequired"
     ],
     "properties": {
      "id": {
       "type": "string"
      },
      "ok": {
       "type": "boolean",
       "const": true
      },
      "plan": {
       "type": "string",
       "const": "quarter"
      },
      "pageId": {
       "type": "string"
      },
      "status": {
       "type": "string"
      },
      "provider": {
       "type": "string",
       "const": "x402"
      },
      "durationDays": {
       "type": "integer",
       "const": 90
      },
      "featuredSlug": {
       "type": "string"
      },
      "approvalRequired": {
       "type": "boolean",
       "const": true
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "x402:agent-request-001",
  "ok": true,
  "plan": "quarter",
  "pageId": "existing-page-id",
  "status": "paid_pending_review",
  "provider": "x402",
  "durationDays": 90,
  "featuredSlug": "my-featured-page",
  "approvalRequired": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/markdown-publishing-markdown-page-featured-quarter-plan-1f4a8124/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from markdown.page](https://www.zero.xyz/host/markdown.page/llms.txt)