Classify API

POST /v1/classify

Classifie un ou plusieurs textes selon plusieurs critères : sentiment, langue, catégories, spam, toxicité.

Paramètres

Réponse

Pour chaque texte, retourne :

• sentiment : positif, négatif, neutre ou mixte
• sentiment_score : -1.0 à 1.0
• language : code ISO 639-1 (fr, en, es...)
• categories : liste de catégories thématiques
• is_spam : détection de spam
• toxicity : 0.0 (inoffensif) à 1.0 (toxique)

Exemple

Requête

{
  "texts": [
    "L'intelligence artificielle révolutionne la médecine en 2026",
    "ACHETEZ MAINTENANT !!! Offre exclusive limitée !!!"
  ]
}

Réponse

{
  "results": [
    {
      "text_preview": "L'intelligence artificielle révolutionne la médecine en 2026",
      "sentiment": "positif",
      "sentiment_score": 0.7,
      "language": "fr",
      "categories": ["technologie", "santé", "intelligence artificielle"],
      "is_spam": false,
      "toxicity": 0.0,
      "error": null
    },
    {
      "text_preview": "ACHETEZ MAINTENANT !!! Offre exclusive limitée !!!",
      "sentiment": "neutre",
      "sentiment_score": 0.1,
      "language": "fr",
      "categories": ["marketing", "commercial"],
      "is_spam": true,
      "toxicity": 0.2,
      "error": null
    }
  ],
  "response_time_ms": 1842
}

Intégration

Python

import requests

resp = requests.post(
    "https://api.s33d.fr/v1/classify",
    headers={"X-API-Key": "s33d_votre_clé_ici"},
    json={
        "texts": [
            "Ce produit est excellent, je recommande !",
            "Service client inexistant, arnaque totale."
        ]
    }
)

for r in resp.json()["results"]:
    print(f"{r['text_preview'][:40]}... → {r['sentiment']} ({r['sentiment_score']})")
    print(f"  Langue: {r['language']}, Spam: {r['is_spam']}, Toxicité: {r['toxicity']}")

JavaScript

const resp = await fetch("https://api.s33d.fr/v1/classify", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "s33d_votre_clé_ici"
  },
  body: JSON.stringify({
    texts: ["Great product!", "Terrible experience."]
  })
});

const { results } = await resp.json();
results.forEach(r => {
  console.log(`${r.sentiment} (${r.sentiment_score}) - spam: ${r.is_spam}`);
});