Name: Language Detector – Identify 73+ Languages | Free · $8/mo | API.market
Brand: flintapis
SKU: api-flintapis-language-probability-detector
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

matchstickn

# ⚡ Language Confidence Detector - Detect Languages With Built-in Confidence Values

## Overview

This API accurately detects languages from given text input, returning a confidence score indicating the certainty of the detection.  Supporting 73 languages, the API provides flexible options for specifying target languages or analyzing against all supported languages.  It also offers a low-accuracy mode for faster processing when performance is critical.  The asynchronous nature of the API allows it to handle longer texts efficiently.

## Features

* **Confidence Values:** Receive a confidence score (0-1) for each language detection.
* **73 Supported Languages:** Detect a wide range of languages.
* **Specified Language Detection:** Optionally limit detection to a specific subset of languages.
* **Low Accuracy Mode:**  Trade accuracy for speed when needed.

## Use Cases

* **Content Moderation:** Automatically filter or categorize multilingual user-generated content based on language.
* **Multilingual Customer Support:** Route customer inquiries to the appropriate support team based on the detected language.
* **E-commerce Product Categorization:** Analyze product descriptions to accurately categorize them by language, improving search and filtering.
* **Automated Translation Workflow:**  Pre-process text to determine the source language before feeding it into a translation engine.
* **Data Analysis and Research:** Analyze large datasets of text to understand language distribution and trends.


## API Documentation

### Base URL

`https://prod.api.market/api/v1/magicapi/language-probability-detector`

### Authentication

Include your API key in the request header:

```
x-magicapi-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing

This API uses asynchronous processing.

1. **POST Request:** Submit a prediction request to the POST endpoint.
2. **Prediction ID:** Receive a prediction ID in the response.
3. **GET Request (Polling):** Poll the GET endpoint with the prediction ID to check status: `/api/v1/magicapi/language-probability-detector/predictions/{id}`.
4. **Polling Interval:** Poll every 1 second.
5. **Timeout:** Implement a maximum timeout of 600 seconds (10 minutes).
6. **Status Checks:** Continue polling while the status is "starting" or "processing".
7. **Success:** When the status is "succeeded", retrieve the results from the "output" field.
8. **Failure:** Handle errors when the status is "failed" or the timeout is reached.


### Endpoints


**POST /api/v1/magicapi/language-probability-detector/v1/detect**

Detects the language of the provided text.

**Request Parameters:**

| Parameter | Type     | Description                       |
| :-------- | :------- | :-------------------------------- |
| `text`      | `string` | **Required Body**. Input text to be inspected for languages. |
|`languages` | `string` | **Optional Query**. Comma-separated list of languages to detect. Defaults to all supported languages.
|`low_accuracy` | `bool` | **Optional Query**. Enables low accuracy mode that priorizes performance over accuracy.

```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/language-probability-detector/v1/detect?languages=en,es,fr&low_accuracy=false" \
-H "Content-Type: application/json" \
-H "x-magicapi-key: YOUR_API_MARKET_KEY" \
-d '{
  "text": "This is a sample text."
}'
```

**Response (200 OK):**

```json
{
  "confidence": "High",
  "confidence_value": 0.95,
  "is_low_accuracy": false,
  "language": "English",
  "languages_searched_for": ["english", "Spanish", "FRENCH"],
  "languages_specified": ["English", "Spanish", "French"]
}
```

**GET /api/v1/magicapi/language-probability-detector/predictions/{id}**

Retrieves the status and result of a prediction.  Replace `{id}` with the prediction ID returned by the POST request.

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/language-probability-detector/predictions/your_prediction_id" \
-H "x-magicapi-key: YOUR_API_MARKET_KEY"
```



## Status Codes

* 200 OK: Request successful.
* 201 Created: Resource successfully created (not typically used for this API).
* 400 Bad Request: Invalid input parameters.
* 401 Unauthorized: Missing or invalid API key.
* 403 Forbidden: Insufficient permissions.
* 404 Not Found: Prediction not found.
* 422 Unprocessable Entity: Validation error.
* 429 Too Many Requests: Rate limit exceeded.
* 500 Internal Server Error: Server-side error.
* 503 Service Unavailable: Service temporarily unavailable.






## Implementation Guide


### Performance Optimization

For optimal performance, specify only the languages you need to detect using the `languages` parameter.  Use the `low_accuracy` mode judiciously, understanding its trade-off between speed and precision.  Implement efficient polling logic with suitable delays and timeouts.

### Notes

The languages searched for are not case sensitive, 
ISO codes will be provided in later updates to this api.


## FAQ

**Q: How accurate are the confidence scores?**

A: The confidence scores are generally highly accurate but can vary if the input text is minimal.

**Q: What should I do if a request times out?**

A: Resubmit the request after checking your network connection and ensuring your input parameters are correct.

## Supported Languages

- **A**
  - Afrikaans
  - Albanian
  - Arabic
  - Armenian
  - Azerbaijani
- **B**
  - Basque
  - Belarusian
  - Bengali
  - Norwegian Bokmal
  - Bosnian
  - Bulgarian
- **C**
  - Catalan
  - Chinese
  - Croatian
  - Czech
- **D**
  - Danish
  - Dutch
- **E**
  - English
  - Esperanto
  - Estonian
- **F**
  - Finnish
  - French
- **G**
  - Ganda
  - Georgian
  - German
  - Greek
  - Gujarati
- **H**
  - Hebrew
  - Hindi
  - Hungarian
- **I**
  - Icelandic
  - Indonesian
  - Irish
  - Italian
- **J**
  - Japanese
- **K**
  - Kazakh
  - Korean
- **L**
  - Latin
  - Latvian
  - Lithuanian
- **M**
  - Macedonian
  - Malay
  - Maori
  - Marathi
  - Mongolian
- **N**
  - Norwegian Nynorsk
- **P**
  - Persian
  - Polish
  - Portuguese
  - Punjabi
- **R**
  - Romanian
  - Russian
- **S**
  - Serbian
  - Shona
  - Slovak
  - Slovene
  - Somali
  - Sotho
  - Spanish
  - Swahili
  - Swedish
- **T**
  - Tagalog
  - Tamil
  - Telugu
  - Thai
  - Tsonga
  - Tswana
  - Turkish
- **U**
  - Ukrainian
  - Urdu
- **V**
  - Vietnamese
- **W**
  - Welsh
- **X**
  - Xhosa
- **Y**
  - Yoruba
- **Z**
  - Zulu

Detect the language of any text with confidence scores. Supports 73 languages. Free 200 calls/mo, from $8/mo. Start free on API.market.

Language Detector – Identify 73+ Languages | Free · $8/mo | API.market

Free