REST API · JSON · HTTPS

API TrustScan

Intégrez la détection d'arnaques dans votre application. Score de confiance instantané sur toute URL de marketplace.

< 200ms

Latence

JSON

Format

HTTPS

Transport

01

Endpoint

Un seul endpoint pour analyser n'importe quelle annonce marketplace.

POST/api/analyse

Paramètres

Paramètre	Type	Requis	Description
`url`	string	required	URL de l'annonce à analyser
`email`	string	optional	Email associé à votre compte Starter ou Pro

Requête

HTTP

POST https://trustscan.nanocorp.app/api/analyse
Content-Type: application/json

{
  "url": "https://www.leboncoin.fr/annonces/2345678.htm",
  "email": "you@example.com"
}

Réponse

JSON

{
  "trustScore": 31,
  "verdict": "Annonce douteuse",
  "verdictDetail": "Plusieurs signaux suspects détectés.",
  "signals": [
    { "label": "Prix anormalement bas", "delta": -20, "type": "danger", "locked": false },
    { "label": "Mot-clé suspect : urgent", "delta": -15, "type": "danger", "locked": false },
    { "label": "Domaine connu", "delta": 15, "type": "safe", "locked": false }
  ],
  "quota": { "plan": "starter", "remaining": 8, "daily_limit": 10 }
}

Codes d'erreur

Code HTTP	Erreur	Description
400	`URL invalide`	Le paramètre url est manquant ou non valide
429	`QUOTA_EXCEEDED`	Limite journalière atteinte — passez à un plan supérieur
422	`LISTING_UNAVAILABLE`	L'annonce est inaccessible (anti-bot, supprimée, etc.)

02

Exemples de code

Copiez-collez pour intégrer TrustScan en quelques lignes.

JavaScript / fetch

const response = await fetch('https://trustscan.nanocorp.app/api/analyse', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    url: 'https://www.leboncoin.fr/annonces/2345678.htm',
    email: 'you@example.com', // optionnel
  }),
});

const data = await response.json();

if (response.ok) {
  console.log(data.trustScore);  // 31
  console.log(data.verdict);     // "Annonce douteuse"
  console.log(data.signals);     // tableau des signaux
} else {
  console.error(data.error);     // "QUOTA_EXCEEDED"
}

cURL

curl -X POST https://trustscan.nanocorp.app/api/analyse \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.leboncoin.fr/annonces/2345678.htm",
    "email": "you@example.com"
  }'

Python / requests

import requests

resp = requests.post(
    "https://trustscan.nanocorp.app/api/analyse",
    json={
        "url": "https://www.leboncoin.fr/annonces/2345678.htm",
        "email": "you@example.com",
    },
)
data = resp.json()
print(data["trustScore"], data["verdict"])