# markdown.page Featured Purchase (Monthly Plan)

> markdown.page Featured Purchase (Monthly Plan) is a paid API for AI agents from markdown.page, paid per call via x402, $29/call, status unknown (last checked 2026-09-14).

Purchases a one-month featured listing slot on markdown.page for an existing page at a specified featured slug, paid via x402.

## Facts

- Endpoint: POST https://markdown.page/api/featured/purchase/month
- Price: $29/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/markdown-page-featured-purchase-monthly-plan-f00d1f7d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FrDDkQ61hIRboUaJBTJjo

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-page-featured-purchase-monthly-plan-f00d1f7d -d '<json body>'
```

Example prompt: Feature my markdown.page article (page ID 'abc-123') in the featured slot called 'ai-tools' for one month — go ahead and pay for it.

## When to prefer this

Use this endpoint when you need to purchase a featured listing specifically on markdown.page for an existing published page, paid via the x402 micropayment protocol. It is purpose-built for the monthly plan at $29 USDC per call. Prefer this over generic ad-placement APIs when the content is already hosted on markdown.page and you want native featured placement that directs markdown.page readers to that article.

## Known failure modes

- Invalid or non-existent pageId returns an error
- featuredSlug not matching pattern ^[a-z0-9-]+$ causes validation failure
- Payment failure via x402 prevents listing creation
- featuredSlug already taken may result in conflict error
- Malformed requestId (not matching required pattern) causes rejection
- Missing required fields (pageId or featuredSlug) returns 400-level error

## 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 the purchase with: a unique listing ID, ok: true, the plan name ('month'), the page ID, the featured slug, payment provider ('x402'), duration (30 days), the current status (typically 'paid_pending_review'), and a flag indicating whether 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": "month"
      },
      "pageId": {
       "type": "string"
      },
      "status": {
       "type": "string"
      },
      "provider": {
       "type": "string",
       "const": "x402"
      },
      "durationDays": {
       "type": "integer",
       "const": 30
      },
      "featuredSlug": {
       "type": "string"
      },
      "approvalRequired": {
       "type": "boolean",
       "const": true
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/markdown-page-featured-purchase-monthly-plan-f00d1f7d/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)