Skip to main content

Translate

Overview

Fracto’s JSON-to-JSON Translation API enables automatic translation of string values in a structured JSON object from one language to another. The structure of the JSON is retained, ensuring a consistent and machine-readable format for downstream applications.

What the API Does

  • Translates only the values in a JSON object; keys remain unchanged.
  • Returns a structured translated JSON.
  • Provides syllable count and cost as part of the response.

API Endpoint ( Dev )

POST https://prod-v2.fracto.tech/translate/

Required Headers

HeaderDescription
x-api-keyYour API Key
Content-TypeMust be application/json

Request Body Parameters

ParameterTypeRequiredDescription
raw_datastringYesJSON object as a string. Only values are translated.
translator_appstringYeshDH62UciQxoamr
source_langstringNoSource language code (default: "en").
target_langstringNoTarget language code (default: "en").

Supported Language Codes

LanguageCodeLanguageCodeLanguageCode
EnglishenHindihiArabicar
MarathimrBengalibnGujaratigu
TamiltaTeluguteKannadakn
MalayalammlPunjabipaSwahilisw
FrenchfrSpanishesPortuguesept
GermandeRussianruChinese (Simplified)zh
JapanesejaKoreankoIndonesianid
TurkishtrItalianitDutchnl
ThaithVietnamesevi

Example cURL Request

curl --location 'https://prod-v2.fracto.tech/translate/' --header 'x-api-key: API_KEY' --header 'Content-Type: application/json' --data-raw '{
"source_lang": "en",
"target_lang": "hi",
"translator_app": "hDH62UciQxoamr",
"raw_data": "{\n \"document_title\": \"Key Facts Statement\",\n \"lender_information\": {\n \"company_name\": \"MS FINCAP PRIVATE LIMITED\",\n \"head_office_address\": \"C-81 B, Chaitanya Marg, C Scheme, Ashok Nagar, Jaipur, Rajasthan\",\n \"phone\": \"9374200200\",\n \"email\": \"info@msfincap.com\",\n \"website\": \"https://msfincap.com\",\n \"cin\": \"U67120RJ2016PTC055220\"\n },\n \"part_1\": {\n \"loan_details\": {\n \"type_of_loan\": \"LOAN AGAINST PROPERTY\",\n \"sanctioned_loan_amount\": 3500000,\n \"borrower_name\": \"Ishan Rawat\",\n \"disbursement_schedule\": [\n \"As per the sanction conditions.\",\n \"Disbursement may be in lump sum or tranches\"\n ],\n \"loan_term\": \"24 Months\",\n \"installment_details\": {\n \"type_of_installments\": \"24 Monthly Equal Amortization\",\n \"epi\": 185049.00,\n \"commencement_of_repayment\": \"04-04-2025\"\n },\n \"interest_rate\": {\n \"rate\": 24,\n \"type\": \"% (Fixed)\"\n }\n },\n \"floating_rate_info\": {\n \"reference_benchmark\": \"LIBOR\",\n \"benchmark_rate_b\": 5.25,\n \"spread_s\": 2.00,\n \"final_rate_r\": \"R = (B) + (S)\",\n \"reset_periodicity_months\": 6,\n \"impact_of_change_in_benchmark\": {\n \"for_25_bps_change_in_r\": {\n \"epi\": 185000.50,\n \"no_of_epis\": 24\n }\n }\n },\n \"fees_and_charges\": {\n \"payable_to_re\": [\n {\n \"one_time_recurring\": \"One Time\",\n \"charge_name\": \"PROCESSING FEES\",\n \"amount_percentage\": 88983.05\n },\n {\n \"one_time_recurring\": \"One Time\",\n \"charge_name\": \"CERSAI CHARGE\",\n \"amount_percentage\": 84.75\n }\n ],\n \"payable_to_third_party\": [],\n \"apr_percentage\": 27.06,\n \"contingent_charges_details\": \"As per agreement\"\n }\n },\n \"part_2\": {\n \"other_information\": [\n {\n \"item\": \"Clause of Loan agreement relating to engagement of recovery agents\",\n \"details\": \"As per the RBI guidelines.\"\n },\n {\n \"item\": \"Clause of loan agreement which details grievance redressal mechanism\",\n \"details\": \"Borrower may write to the Lender at info@msfincap.com\"\n }\n ],\n \"additional_charges\": {\n \"cheque_bounce_charges\": \"INR 1000/- per instance\",\n \"prepayment_charges\": \"4% of the prepayment amount\",\n \"foreclosure_charges\": \"8% of Principle Outstanding\",\n \"penal_charges_on_emi_default\": \"4% monthly on overdue amount\",\n \"statement_of_account_charges\": \"INR 500/-\",\n \"noc_ndc_charges\": \"INR 500/-\",\n \"duplicate_repayment_schedule_charges\": \"INR 500/- Per request\",\n \"photocopy_of_security_documents\": \"INR 100/- per page\",\n \"certificate_of_possession_charges\": \"INR 5000/- per certificate\",\n \"e_nach_failure_charges\": \"INR 500/-\",\n \"file_cancellation_charges\": \"INR 5000/-\",\n \"file_documents_verification_charges\": {\n \"up_to_5_lacs\": \"INR 3,000/-\",\n \"5.01_to_7.5_lacs\": \"INR 3,750/-\"\n },\n \"collection_charges\": \"INR 500/- per visit\",\n \"cersai_charges\": \"INR 100/-\"\n },\n \"apr_illustration\": {\n \"parameters\": [\n {\n \"sr_no\": 1,\n \"parameter\": \"Sanctioned Loan Amount (in Rupees)\",\n \"details\": 3500000\n },\n {\n \"sr_no\": 2,\n \"parameter\": \"Loan Term (in months)\",\n \"details\": 24\n },\n {\n \"sr_no\": \"a)\",\n \"parameter\": \"Type of EMI, Amount of each EMI (in Rupees), and nos. of EMIs\",\n \"details\": 185049\n }\n ]\n },\n \"repayment_schedule_illustration\": {\n \"schedule_details\": [\n {\n \"instalment_no\": 1,\n \"outstanding_principal\": 3384951,\n \"principal\": 115049,\n \"interest\": 70000,\n \"instalment\": 185049\n },\n {\n \"instalment_no\": 2,\n \"outstanding_principal\": 3267601,\n \"principal\": 117350,\n \"interest\": 67699,\n \"instalment\": 185049\n },\n {\n \"instalment_no\": 3,\n \"outstanding_principal\": 3147904,\n \"principal\": 119697,\n \"interest\": 65352,\n \"instalment\": 185049\n }\n ]\n }\n }\n}"
}'

Sample Response

{
"source": "English",
"target": "Hindi",
"job_id": 101,
"translated_data": {
"document_title": "मूल तथ्य विवरण"
},
"syllables_used": 6,
"translation_cost": 0.18
}

Billing & Pricing

  • Billing is based on syllables translated.
  • 1,000 syllables = 1 billing unit.
  • Minimum billing: 1,000 syllables per request, even for smaller inputs.

Example: If your JSON contains 2,450 syllables and the rate is ₹10 per 1,000 syllables, your cost would be calculated accordingly.
Spaces & keys are counted as syllables.


Response Fields

FieldDescription
syllables_usedTotal syllables processed in the request
translation_costCost of translation as per configured rates

Considerations

TopicDetail
JSON Formattingraw_data must be passed as a stringified JSON (escaped format).
Structure PreservationOnly values are translated. All keys remain as-is.
Language CodesUse only standard ISO codes (e.g., en, hi, mr, ar).
Translator App IDMust be valid and mapped to your API key.
Nested Objects & ArraysValues inside nested JSON structures are translated recursively.
Error HandlingInvalid JSON or language codes will result in a 4xx error.
AuthenticationRequests without a valid x-api-key will be rejected.