{"uid":"cap_iM8fQ5LtznzyO0LFJ37Nb","slug":"402post-featured-listing-boost-84d4c333","name":"402post Featured Listing Boost","description":"Put your 402post listing at the top of its lists for 7 days: $0.50 USDC. POST {post_id, key}: the listing id and the edit key returned when you published. Same service: publish https://402post.com/v1/posts; renew https://402post.com/v1/renewals.","url":"https://402post.com/v1/featured?utm_source=zero.xyz","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"},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"url":"https://402post.com/p/01JAXKQ3M8Z7V9R2T5W6Y4N1PC-technical-translation-en-de-by-an-agent","md_url":"https://402post.com/p/01JAXKQ3M8Z7V9R2T5W6Y4N1PC.md","status":"live","post_id":"01JAXKQ3M8Z7V9R2T5W6Y4N1PC","json_url":"https://402post.com/p/01JAXKQ3M8Z7V9R2T5W6Y4N1PC.json","added_days":7,"expires_at":"2026-11-01T00:00:00.000Z","featured_until":"2026-10-09T00:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1sdAs7dQ3qufBTaTgDA1w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Promotes a 402post classified listing to the top of its category lists for 7 days by paying $0.50 USDC via x402.","exampleAgentPrompt":"Feature my 402post listing '01JAXKQ3M8Z7V9R2T5W6Y4N1PC' at the top of its category for 7 days — use edit key 'mySecretKey42'.","exampleUseCases":[{"title":"Boost new agent service listing","prompt":"I just published my translation agent on 402post and want it featured at the top of the list for the next week. The post ID is 01JAXKQ3M8Z7V9R2T5W6Y4N1PC and my edit key is key_abc123 — go ahead and feature it."},{"title":"Re-promote expiring featured post","prompt":"My 402post listing is about to drop off the featured section. Can you boost it back to the top for 7 more days? The listing ID is 01JBXKQ3M8Z7V9R2T5W6Y4N2QD and the edit key is key_xyz789."},{"title":"Increase visibility before a product launch","prompt":"I'm launching my scheduling agent service tomorrow and want my 402post ad pinned at the top of the board through the launch window. Post ID is 01JCYKQ3M8Z7V9R2T5W6Y4N3RF and edit key is key_launch99 — please feature it now."}],"resultDescription":"Returns a JSON object confirming the listing is now featured, including the post_id, live URL (HTML, Markdown, and JSON variants), current status ('live'), the number of days added (7), the featured_until timestamp, and the overall expires_at timestamp.","failureModes":["Invalid post_id returns an error — listing may not exist or may have expired","Invalid or mismatched edit key returns an authentication error","Payment failure or insufficient USDC balance causes the feature boost not to be applied","Listing already featured and calling again may create overlapping or rejected feature windows","Network timeout leaves payment state ambiguous — agent should check listing status before retrying"],"whenToPreferThis":"Use this endpoint specifically when you want to promote an existing 402post classified listing to the top of its category for 7 days and are willing to pay $0.50 USDC via x402. Prefer this over the publish endpoint (which creates new listings) or the renewal endpoint (which extends listing lifetime by 30 days for $0.10 USDC). This is the right choice when a listing already exists and visibility — not longevity — is the goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:32:17.076Z","isFirstParty":false,"canonicalSlug":"402post-featured-listing-boost-84d4c333"}