{"uid":"cap_JuYPSmXyS3xH2gQ6VMaf7","slug":"farsi-text-normalizer-fc1f6e28","name":"Farsi Text Normalizer","description":"Persian (Farsi) and Iranian utility API for AI agents. Text normalization, transliteration, Jalali (Solar Hijri) calendar conversion, Persian digits and number-to-words, Iranian national ID / Sheba (IBAN) / mobile / landline / postal code / bank card (Luhn PAN) / company ID / economic code validators, Iranian provinces and cities, official Jalali holidays, Rial-Toman conversion. Also a FIXED-PRICE deliverable SKU: Persian/Arabic data cleanup at $0.90, $9 or $25 flat per file (not per call) - upload a CSV, TSV or text file and get it back normalized, with an optional Latin transliteration column. Pay per request in USDC on Base via x402 - no signup, no API key, no KYC.","url":"https://farsi-tools.johnaio281.workers.dev/api/fa/normalize?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Persian (Farsi) text or value to process. Max 100000 characters."},"options":{"type":"object","description":"optional, e.g. {\"digits\":\"ascii\"}"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"output":"دنیا کوچک ۱۲۳","input_len":15}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8MieQkg8M3wXvOFho_gaS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Normalizes Persian (Farsi) text, standardizing characters, digits, and encoding inconsistencies into a canonical form","exampleAgentPrompt":"Can you normalize this Persian text for me: 'دنیا کوچک ١٢٣' — and convert any Persian digits to ASCII while you're at it?","exampleUseCases":[{"title":"Normalize user-submitted Farsi form input","prompt":"I'm getting Persian text from a web form that mixes Arabic and Persian characters inconsistently — can you normalize this string 'کتابخانه‌ی عمومی' so it's standardized before I store it in the database?"},{"title":"Convert Persian digits to ASCII for data pipeline","prompt":"I have this Farsi text '۱۲۳ محصول موجود است' where the numbers are in Persian digit format — can you normalize it and convert those digits to ASCII so my data pipeline can parse the numbers?"},{"title":"Standardize Farsi text before NLP analysis","prompt":"Before I run sentiment analysis on this Persian customer review, can you normalize the text 'خدمات عالی بود ولی قیمت‌ها گران هستند' so all the characters are in canonical Farsi form?"}],"resultDescription":"A JSON object containing the normalized Persian text under the 'output' key and the character count of the input under 'input_len'. For example: {\"output\": \"دنیا کوچک 123\", \"input_len\": 15}. The normalized text will have standardized Persian/Arabic character variants, consistent digit formats, and cleaned Unicode representations.","failureModes":["Missing required 'text' query parameter returns an error response","Input text exceeding 100,000 characters may be rejected or truncated","Invalid options object format may cause unexpected behavior","Payment failure via x402 (insufficient USDC balance) results in 402 Payment Required","Network timeouts on the Cloudflare Workers edge in rare cases"],"whenToPreferThis":"Choose this endpoint when you need to normalize Persian or Farsi text specifically — standardizing character variants (e.g. Arabic 'ك' vs Persian 'ک'), digit formats (Eastern Arabic vs ASCII numerals), and Unicode inconsistencies. Ideal as a preprocessing step before storing Farsi text in databases, feeding it into NLP pipelines, or comparing strings. Prefer this over a generic Unicode normalizer when working specifically with Persian/Farsi language text that may have mixed Arabic/Persian encoding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:36:28.439Z","isFirstParty":false,"canonicalSlug":"farsi-text-normalizer-fc1f6e28"}