NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Text Language API

The Text Language API detects the language of any given text, supporting over 50 different languages.

Online
(4.2)

From 9,370 users

1,000+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
306ms343ms365ms795ms1139ms

Didn't find what you were looking for? Suggest an improvement

https://api.api-ninjas.com/v1/textlanguage

Returns the language name and 2-letter ISO language code for a given block of text string.

Parameters

  • text  required

    Input text (10 words or more recommended). Maximum 1000 characters.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • iso

    ISO 639-1 language code (e.g., en, es, fr).

  • language

    Full name of the detected language (e.g., English, Spanish, French).

Live Demo

Live demo · no API key required
Query parameters
text

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/textlanguage?text=Hello world!
Sample response
{
"iso": "en",
"language": "English"
}

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/textlanguage?text=Hello%20world!" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Text Language API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Send a GET request to the /v1/textlanguage endpoint with your text passed in the required text query parameter; the API supports over 50 different languages. You can try it on the live demo on this page or register for a free API key to get started.
  • The response is a JSON object containing two fields: iso, the ISO 639-1 two-letter language code (e.g. en, es, fr), and language, the full name of the detected language (e.g. English, Spanish, French). If a request is unsuccessful, you will receive an error instead, documented on our error codes page.
  • The text parameter accepts a maximum of 1000 characters, and we recommend supplying at least 10 words for the most accurate detection. For higher request volumes, see our pricing plans.
  • It is ideal for routing multilingual support tickets, tagging user-generated content by language, and pre-processing text before downstream NLP tasks. You can pair it with our Sentiment API or Spell Check API to build a complete text analysis pipeline.

Explore API integration use cases for recommended APIs and workflow examples.