{"uid":"cap_u8dC89crurQNYet65OvrW","slug":"netintel-dev-structured-content-translation-5d490512","name":"netintel.dev Structured Content Translation","description":"Translate structured content — JSON, HTML, Markdown, templates, UI strings — without breaking structure. Preserves keys, tags, markdown, URLs, emails, variables, placeholders, code blocks, and brand names, honors a caller glossary, and validates that no placeholder was dropped, so agents can localize app content safely.","url":"https://netintel.dev/translate/structured","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":["content","target"],"properties":{"tone":{"type":"string","description":"Optional tone guidance, e.g. \"friendly and concise\"."},"locale":{"type":"string","description":"Target locale for regional variants, e.g. \"fr-CA\"."},"source":{"type":"string","description":"Source language. Auto-detected when omitted."},"target":{"type":"string","description":"Target language — ISO 639-1 code (\"fr\") or English name (\"French\"). Aliases also accepted: target_lang, target_language, to, lang."},"content":{"type":"object","description":"The structured content to translate: a JSON object/array, or a string of HTML, Markdown, or template text. Max 32KB / 500 strings."},"glossary":{"type":"object","description":"Enforced term mappings: {\"dashboard\":\"tableau de bord\"}. Compliance is reported per term; a missed term costs 10 points."},"formality":{"type":"string","description":"\"formal\", \"informal\", or \"neutral\" (default)."},"content_type":{"type":"string","description":"One of \"json\", \"html\", \"markdown\", \"template\", \"text\". Auto-detected when omitted; a non-string content is always treated as json."},"protected_values":{"type":"array","description":"Strings that must pass through byte-for-byte — brand names, IDs, SKUs: [\"Acme\",\"SKU-1234\"]. Dropping one fails the call."}}},"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","properties":{"grade":{"type":"string","description":"Letter grade A-F derived from score"},"score":{"type":"number","description":"0-100; 100 on a clean, structure-valid translation"},"findings":{"type":"array","description":"Scored deductions, e.g. glossary_missed"},"warnings":{"type":"array","description":"Non-fatal notes, e.g. a missed glossary term"},"translated":{"type":"object","description":"The translated document, in the same shape and format as the input"},"content_type":{"type":"string","description":"The content type used (given or auto-detected)"},"target_language":{"type":"string","description":"ISO 639-1 code translated into"},"detected_language":{"type":"string","description":"ISO 639-1 code of the source language"},"glossary_compliance":{"type":"object","description":"Which glossary terms were applied and which were missed"},"structure_validation":{"type":"object","description":"Proof the document still parses: JSON keys intact, HTML tags balanced, markdown syntax preserved"},"placeholder_validation":{"type":"object","description":"Proof that every placeholder, tag, URL, email, code span, and protected value survived. A drop is a 502, never a 200."}}}}}}},"responseSchema":{"type":"json","example":{"grade":"A","score":100,"findings":[],"warnings":[],"translated":{"cta":"Cliquez ici pour ouvrir le tableau de bord","greeting":"Bonjour {{name}}"},"content_type":"json","target_language":"fr","detected_language":"en","glossary_compliance":{"missed":[],"applied":["dashboard→tableau de bord"]},"structure_validation":{"type":"json","passed":true},"placeholder_validation":{"found":["{{name}}"],"passed":true,"missing":[],"expected":["{{name}}"]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j-Jk150eJ-tRA1ix6K2lO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Translates structured content (JSON, HTML, Markdown, templates) into a target language while preserving structure, placeholders, tags, URLs, and glossary terms.","exampleAgentPrompt":"Translate this JSON locale file to French (fr-CA) with a formal tone — use 'tableau de bord' for 'dashboard' in the glossary, and make sure none of the {{placeholder}} variables or the brand name 'Acme' get changed.","exampleUseCases":[{"title":"App i18n JSON file localization","prompt":"Take this JSON translation file for our React app and translate all the string values to German, keeping all the {{variable}} placeholders exactly as-is, and never translate the brand name 'CloudSync'. Give me the translated JSON back with the same keys."},{"title":"HTML email template localization","prompt":"Translate this HTML email template into Spanish for Latin America (es-MX) with a friendly tone — keep all the HTML tags, links, and the placeholders like {{first_name}} and {{unsubscribe_url}} completely untouched."},{"title":"Markdown docs translation with glossary","prompt":"Translate this Markdown documentation page to Japanese, keep all code blocks and URLs unchanged, and use 'ダッシュボード' for every occurrence of 'dashboard' as per our glossary. Tell me if any glossary terms were missed."}],"resultDescription":"Returns the translated structured content in the same format as the input, along with a 0-100 quality score, a letter grade (A-F), per-term glossary compliance results, and a validation report confirming that all placeholders and protected values were preserved.","failureModes":["Content exceeds 32KB or 500 string limit — request rejected","A protected_value string is missing from the translation — call fails validation","Unsupported or unrecognized target language code — error returned","Malformed input structure (not valid JSON/HTML/Markdown) — parsing error","Glossary term not honored — score deducted (10 points per missed term)","Network or upstream LLM timeout — transient 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to localize structured content (JSON locale files, HTML templates, Markdown docs, i18n strings) and cannot risk breaking structure, dropping placeholders, or mistranslating enforced glossary terms. It is purpose-built for software localization workflows where structural fidelity and placeholder preservation are non-negotiable, unlike generic translation APIs that treat input as plain text. Prefer it over batch string translation endpoints when your content is a single structured document rather than independent strings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:58.918Z","isFirstParty":false}