{"uid":"cap_eJmDI4_iSrW3ZOBC10-PT","slug":"markdown-page-featured-purchase-weekly-slot-9011f649","name":"markdown.page Featured Purchase — Weekly Slot","description":"Publish Markdown to a public URL. Browsers receive HTML; command-line tools and agents receive plain text. No account or API key required.","url":"https://markdown.page/api/featured/purchase/week","method":"POST","headers":{},"bodySchema":{"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":"week"},"pageId":{"type":"string"},"status":{"type":"string"},"provider":{"type":"string","const":"x402"},"durationDays":{"type":"integer","const":7},"featuredSlug":{"type":"string"},"approvalRequired":{"type":"boolean","const":true}}}}}}},"responseSchema":{"type":"json","example":{"id":"x402:agent-request-001","ok":true,"plan":"week","pageId":"existing-page-id","status":"paid_pending_review","provider":"x402","durationDays":7,"featuredSlug":"my-featured-page","approvalRequired":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"9","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$9/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"9","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"9","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Lcb80S2S4_iRTM-9AxMOO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"9","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase a one-week featured listing slot for an existing markdown.page page on a chosen featured slug, paid via x402.","exampleAgentPrompt":"Can you purchase a one-week featured slot on markdown.page for my page ID 'abc123', listing it under the featured slug 'my-awesome-guide'?","exampleUseCases":[{"title":"Promote a technical guide for a week","prompt":"I just published a markdown.page guide and I want it featured for the next week — the page ID is 'guide-xyz' and I'd like the featured slug to be 'ai-tools-guide'. Can you buy the weekly featured slot for it?"},{"title":"Sponsor an open-source project page","prompt":"I have a markdown.page project page with ID 'oss-project-42' and I want to get it featured under the slug 'open-source-tools' for a week so more people discover it. Please purchase the weekly featured listing."},{"title":"Agent-automated content promotion","prompt":"After publishing my weekly newsletter page on markdown.page (page ID: 'newsletter-2024-22'), automatically buy a one-week featured slot for it under the slug 'weekly-reads' so it gets visibility right away."}],"resultDescription":"Returns a JSON object confirming the purchase, including a unique purchase ID, the plan ('week'), the pageId and featuredSlug, a status of 'paid_pending_review' indicating human approval is required before the page goes live as featured, the duration in days (7), and a flag confirming approval is required.","failureModes":["Invalid or non-existent pageId — page must already exist on markdown.page","featuredSlug not matching the required pattern (lowercase alphanumeric and hyphens only)","Payment failure via x402 — insufficient funds or unsupported wallet","requestId not matching required pattern or duplicate requestId causing conflict","articleUrl not a valid public markdown.page URL","Featured slug already taken or unavailable for the requested week"],"whenToPreferThis":"Use this endpoint when you have an existing markdown.page page and want to pay for a one-week featured promotion slot under a specific slug. This is the right choice when the goal is content promotion and discovery on the markdown.page platform specifically, funded via x402 crypto payment. It is not for creating new pages, for featured placements longer or shorter than a week, or for promotion on other publishing platforms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:02.825Z","isFirstParty":false}