{"uid":"cap_zm1r2GKWiq655l7BD3Uv9","slug":"promptqualityscore-com-fc9e687f","name":"PQS /api/score — 8-Dimension Prompt Quality Scorer","description":"A Quality Gate For Prompts. Before they break production. Score any AI prompt against 8 dimensions, see what's weak, and get the fixed version in seconds.","url":"https://promptqualityscore.com/api/score?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":10000,"minLength":1,"description":"Prompt to score"},"vertical":{"enum":["software","content","business","education","science","crypto","general","research"],"type":"string","default":"general","description":"Domain: software/content/business/education/science/crypto/general/research"}}},"responseSchema":{"type":"json","example":{"score":{"grade":"C","total":46,"out_of":80,"dimensions":{"total":46,"clarity":7,"context":6,"examples":4,"constraints":5,"specificity":6,"cot_structure":6,"output_format":7,"role_definition":5},"percentile":58},"prompt":"Explain PQS scoring in one sentence to an AI agent operator.","upgrade":"For optimized prompt call /api/score/full at $0.125 USDC","vertical":"general","top_fixes":["Specify the exact output format you want (bullets, JSON, prose).","Name the target reader or persona explicitly.","Add one concrete example of the ideal response."],"powered_by":"PQS - promptqualityscore.com","pqs_version":"2.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-OCFEHtyzkdXBSg_2MyRv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores a prompt across 8 dimensions (clarity, context, examples, constraints, specificity, chain-of-thought structure, output format, role definition) with a grade, percentile, and top 3 actionable fixes","exampleAgentPrompt":"Can you score this prompt for a software task and tell me the grade, dimension breakdown, and top 3 things to fix? Prompt: 'You are a senior engineer. Review the following code and suggest improvements focusing on performance.'","exampleUseCases":[{"title":"Pre-flight quality check for customer support prompts","prompt":"Before I deploy this prompt to our support chatbot, can you score it and tell me if it's good enough to use? I want to know the grade and which dimensions need the most work."},{"title":"Debug why my data extraction prompt fails","prompt":"I've been getting inconsistent results from my data extraction prompt. Can you break down the quality across all dimensions and give me the top 3 specific things I should fix?"},{"title":"Optimize prompts across a prompt library","prompt":"I've got a bunch of prompts my team wrote for different tasks. Can you score each one and rank them by overall quality? I want to see the letter grades and dimension breakdown so I know which ones need rework."}],"resultDescription":"Returns a structured object with: a total score (8–80), letter grade (A–F), percentile rank, individual scores for all 8 dimensions (clarity, context, examples, constraints, specificity, cot_structure, output_format, role_definition), an upgraded prompt string, and exactly 3 specific fix recommendations","failureModes":["Missing required 'prompt' field — returns validation error","Prompt too short or empty — may return low scores or error","Invalid vertical value — falls back to 'general' or returns validation error","Network timeout on large prompts","Payment failure (x402) — endpoint returns 402 if USDC payment not attached"],"whenToPreferThis":"Use this endpoint when you need a detailed, multi-dimensional quality breakdown of a prompt with dimension-level sub-scores and prioritized fixes — not just a pass/fail or single composite score. Ideal for prompt debugging workflows, prompt optimization pipelines, or pre-flight filtering before expensive LLM calls where you want to understand *why* a prompt is weak and exactly what to fix.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:39:33.327Z","isFirstParty":false,"canonicalSlug":"promptqualityscore-com-fc9e687f"}