{"openapi":"3.1.0","info":{"title":"Listing Roast x402","version":"0.2.0","description":"Paid x402 API for marketplace listing score, paid API listing quality, marketplace listing conversion, and x402 service discoverability before promotion.","x-keywords":["marketplace listing score","marketplace listing quality","marketplace listing conversion","paid API listing","x402 listing","x402 service discoverability"]},"servers":[{"url":"https://listing-roast-x402-service-production.up.railway.app"}],"paths":{"/api/instant-listing-score":{"get":{"tags":["x402 listing","paid API listing"],"summary":"Paid $0.001 instant marketplace listing score","description":"Lowest-friction GET route for buyer agents that want an immediate paid API listing quality score without building a JSON body first. Optional query params: agentName, listingText, targetBuyer, currentPrice, currentCheckoutPath, goal.","parameters":[{"name":"agentName","in":"query","required":false,"schema":{"type":"string"}},{"name":"listingText","in":"query","required":false,"schema":{"type":"string"}},{"name":"targetBuyer","in":"query","required":false,"schema":{"type":"string"}},{"name":"currentPrice","in":"query","required":false,"schema":{"type":"string"}},{"name":"currentCheckoutPath","in":"query","required":false,"schema":{"type":"string"}},{"name":"goal","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paid instant listing score response","content":{"application/json":{"schema":{"type":"object","required":["service","endpoint","price","verdict","score","checkedSignals","firstFix","nextStep","upgradeEndpoint"],"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"price":{"type":"string"},"verdict":{"type":"string"},"score":{"type":"string"},"checkedSignals":{"type":"object"},"firstFix":{"type":"string"},"nextStep":{"type":"string"},"upgradeEndpoint":{"type":"string"}}},"example":{"service":"Listing Roast x402","endpoint":"instant-listing-score","price":"$0.001","verdict":"ready_to_test","score":"5/5","checkedSignals":{"buyer":true,"price":true,"output":true,"checkout":true,"example":true},"firstFix":"The basics are present. Use the full roast only if you want a rewrite and launch recommendation.","nextStep":"This GET route is the lowest-friction paid check. Use /api/listing-score for a scored POST payload or /api/listing-roast for the full rewrite.","upgradeEndpoint":"/api/listing-score"}}}},"402":{"description":"x402 payment required"}}}},"/api/x402-ping":{"get":{"tags":["x402 ping","paid API listing"],"summary":"Paid $0.001 x402 rail ping","description":"Tiny paid GET endpoint for agents that want to verify the Base x402 payment rail before buying a richer listing score or roast.","parameters":[{"name":"msg","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paid x402 ping response","content":{"application/json":{"schema":{"type":"object","required":["service","endpoint","price","ok","message","timestamp","paidRoutes","nextStep"],"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"price":{"type":"string"},"ok":{"type":"boolean"},"message":{"type":"string"},"timestamp":{"type":"string"},"paidRoutes":{"type":"object"},"nextStep":{"type":"string"}}},"example":{"service":"Listing Roast x402","endpoint":"x402-ping","price":"$0.001","ok":true,"message":"hello from x402","timestamp":"2026-06-13T10:51:14.810Z","paidRoutes":{"instantScore":"/api/instant-listing-score","indexedQuickScore":"/api/listing-roast","score":"/api/listing-score","fullRoast":"/api/listing-roast"},"nextStep":"Use this paid ping to verify the x402 rail, then call /api/listing-roast with GET for a quick score or POST for the full roast."}}}},"402":{"description":"x402 payment required"}}}},"/api/listing-score":{"post":{"tags":["x402 listing","paid API listing"],"summary":"Paid $0.005 marketplace listing score","description":"Scores paid API marketplace listing quality, conversion clarity, x402 service discoverability, checked signals, first fix, and upgrade guidance after x402 payment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agentName","listingText"],"properties":{"agentName":{"type":"string"},"listingText":{"type":"string"},"targetBuyer":{"type":"string"},"currentPrice":{"type":"string"},"currentCheckoutPath":{"type":"string"},"goal":{"type":"string"},"source":{"type":"string"}}},"example":{"agentName":"Example x402 API","listingText":"A paid x402 API that helps builders check whether buyer agents understand the offer before paying. It returns JSON with skip reasons, top fixes, a rewritten listing, and a stop-or-upgrade recommendation. Example payloads are included for quick testing.","targetBuyer":"x402 and MCP builders","currentPrice":"$1.00","currentCheckoutPath":"/api/listing-roast","goal":"Increase first paid conversion"}}}},"responses":{"200":{"description":"Paid listing score response","content":{"application/json":{"schema":{"type":"object","required":["service","endpoint","price","verdict","score","checkedSignals","firstFix","nextStep","upgradeEndpoint"],"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"price":{"type":"string"},"verdict":{"type":"string"},"score":{"type":"string"},"checkedSignals":{"type":"object"},"firstFix":{"type":"string"},"nextStep":{"type":"string"},"upgradeEndpoint":{"type":"string"}}},"example":{"service":"Listing Roast x402","endpoint":"listing-score","price":"$0.005","verdict":"ready_to_test","score":"5/5","checkedSignals":{"buyer":true,"price":true,"output":true,"checkout":true,"example":true},"firstFix":"The basics are present. Use the full roast only if you want a rewrite and launch recommendation.","nextStep":"Ready to test. Pay for the full roast only if you want the rewritten listing and stop-or-upgrade guidance.","upgradeEndpoint":"/api/listing-roast"}}}},"402":{"description":"x402 payment required"}}}},"/api/listing-roast":{"get":{"tags":["x402 listing","paid API listing"],"summary":"Paid $0.001 indexed listing-roast quick score","description":"Lowest-price GET challenge on the already-indexed /api/listing-roast URL. Returns an instant marketplace listing score after x402 payment. Use POST on the same URL for the full $0.01 roast.","parameters":[{"name":"agentName","in":"query","required":false,"schema":{"type":"string"}},{"name":"listingText","in":"query","required":false,"schema":{"type":"string"}},{"name":"targetBuyer","in":"query","required":false,"schema":{"type":"string"}},{"name":"currentPrice","in":"query","required":false,"schema":{"type":"string"}},{"name":"currentCheckoutPath","in":"query","required":false,"schema":{"type":"string"}},{"name":"goal","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paid quick score response from the indexed listing-roast URL","content":{"application/json":{"schema":{"type":"object","required":["service","endpoint","price","verdict","score","checkedSignals","firstFix","nextStep","upgradeEndpoint"],"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"price":{"type":"string"},"verdict":{"type":"string"},"score":{"type":"string"},"checkedSignals":{"type":"object"},"firstFix":{"type":"string"},"nextStep":{"type":"string"},"upgradeEndpoint":{"type":"string"}}},"example":{"service":"Listing Roast x402","endpoint":"listing-roast-quick-score","price":"$0.001","verdict":"ready_to_test","score":"5/5","checkedSignals":{"buyer":true,"price":true,"output":true,"checkout":true,"example":true},"firstFix":"The basics are present. Use the full roast only if you want a rewrite and launch recommendation.","nextStep":"This GET route keeps the indexed /api/listing-roast URL payable at the lowest price. Use POST /api/listing-roast for the full rewrite and launch recommendation.","upgradeEndpoint":"/api/listing-roast"}}}},"402":{"description":"x402 payment required"}}},"post":{"tags":["x402 listing","paid API listing"],"summary":"Paid $0.01 marketplace listing conversion roast","description":"Returns paid API listing conversion feedback, marketplace listing quality fixes, buyer-agent skip reasons, rewritten listing copy, and stop-or-upgrade guidance after x402 payment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agentName","listingText"],"properties":{"agentName":{"type":"string"},"listingText":{"type":"string"},"targetBuyer":{"type":"string"},"currentPrice":{"type":"string"},"currentCheckoutPath":{"type":"string"},"goal":{"type":"string"},"source":{"type":"string"}}},"example":{"agentName":"Example x402 API","listingText":"A paid x402 API that helps builders check whether buyer agents understand the offer before paying. It returns JSON with skip reasons, top fixes, a rewritten listing, and a stop-or-upgrade recommendation. Example payloads are included for quick testing.","targetBuyer":"x402 and MCP builders","currentPrice":"$1.00","currentCheckoutPath":"/api/listing-roast","goal":"Increase first paid conversion"}}}},"responses":{"200":{"description":"Paid full roast response","content":{"application/json":{"schema":{"type":"object","required":["service","endpoint","price","verdict","score","buyerAgentSkipReasons","topFixes","rewrittenListing"],"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"price":{"type":"string"},"verdict":{"type":"string"},"score":{"type":"string"},"buyerAgentSkipReasons":{"type":"array","items":{"type":"string"}},"topFixes":{"type":"array","items":{"type":"string"}},"rewrittenListing":{"type":"string"},"stopOrUpgrade":{"type":"string"},"nextMeasurement":{"type":"string"}}},"example":{"service":"Listing Roast x402","endpoint":"listing-roast","price":"$0.01","verdict":"ready_to_test","score":"5/5","input":{"agentName":"Example x402 API","targetBuyer":"x402 and MCP builders","currentPrice":"$1.00","currentCheckoutPath":"/api/listing-roast","goal":"Increase first paid conversion"},"buyerAgentSkipReasons":[],"topFixes":["Keep the buyer, price, output, and checkout path visible in the first screen.","Add one copy-paste payload for the most likely buyer.","Track whether visitors reach the unpaid 402 challenge before changing the offer."],"rewrittenListing":"Example x402 API helps x402 and MCP builders improve a paid agent/API listing before promotion. For $1.00, call /api/listing-roast to get A paid x402 API that helps builders check whether buyer agents understand the offer before paying. Use it when the listing is live enough to sell, but the buyer, output, price, or checkout promise may still be unclear.","stopOrUpgrade":"Stop editing and test paid traffic. Upgrade only if qualified buyers reach the 402 challenge but do not complete payment.","nextMeasurement":"Watch page views, unpaid 402 challenges, paid completions, and refund/complaint signals separately."}}}},"402":{"description":"x402 payment required"}}}},"/api/sample-score":{"get":{"summary":"Free sample score output","responses":{"200":{"description":"Sample request, command, and score output"}}}}},"x-listing-roast":{"homepage":"https://listing-roast-x402-service-production.up.railway.app","builder":"https://listing-roast-x402-service-production.up.railway.app/builder","sample":"https://listing-roast-x402-service-production.up.railway.app/sample","x402Manifest":"https://listing-roast-x402-service-production.up.railway.app/x402.json","instantScoreRoute":"https://listing-roast-x402-service-production.up.railway.app/api/instant-listing-score","pingRoute":"https://listing-roast-x402-service-production.up.railway.app/api/x402-ping","scoreRoute":"https://listing-roast-x402-service-production.up.railway.app/api/listing-score","roastRoute":"https://listing-roast-x402-service-production.up.railway.app/api/listing-roast","instantScorePrice":"$0.001","scorePrice":"$0.005","roastPrice":"$0.01","network":"eip155:8453","keywords":["marketplace listing score","marketplace listing quality","marketplace listing conversion","paid API listing","x402 listing","x402 service discoverability"]}}