Deepfake scan
curl --request POST \
--url https://api.truthlocks.com/v1/risk/deepfake/scan \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"subject_ref": "<string>",
"subject_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({subject_ref: '<string>', subject_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/risk/deepfake/scan', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/risk/deepfake/scan"
payload = {
"subject_ref": "<string>",
"subject_type": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/risk/deepfake/scan"
payload := strings.NewReader("{\n \"subject_ref\": \"<string>\",\n \"subject_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"scan_id": "<string>",
"status": "<string>",
"subject_ref": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Risk Signals
Deepfake & impersonation scan
Submit a subject for deepfake and impersonation analysis. Returns scores, verdict, and indicators. Automatically ingests a risk signal if scores exceed the auto-trigger threshold (60).
POST
/
v1
/
risk
/
deepfake
/
scan
Deepfake scan
curl --request POST \
--url https://api.truthlocks.com/v1/risk/deepfake/scan \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"subject_ref": "<string>",
"subject_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({subject_ref: '<string>', subject_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/risk/deepfake/scan', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/risk/deepfake/scan"
payload = {
"subject_ref": "<string>",
"subject_type": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/risk/deepfake/scan"
payload := strings.NewReader("{\n \"subject_ref\": \"<string>\",\n \"subject_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"scan_id": "<string>",
"status": "<string>",
"subject_ref": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}This endpoint does not download or inspect the referenced image, video, or document. It scores indicators or scores supplied by your application. Values are heuristic risk scores, not calibrated probabilities. The
authentic label means the configured risk threshold was not reached; it is not proof that media is authentic, especially when no indicators were supplied.How detection works
Scans use a heuristic signal engine (heuristic_v1) that accepts caller-provided signals (from external ML models, rule engines, or manual review) and maps them to weighted scores:
- Deepfake indicators: face swap, inconsistent lighting, compression artifacts, temporal inconsistency, metadata mismatch
- Impersonation indicators: biometric mismatch, name mismatch, identity doc mismatch, issuer trust violation
deepfake or impersonation. Scores ≥ 40 set suspect. Scores ≥ 60 automatically ingest a risk signal.
You can also bypass heuristic analysis by passing pre-computed deepfake_score and impersonation_score values directly. The platform still applies the same verdict thresholds and automatic signal ingestion.
See the deepfake detection guide for the full workflow, indicator reference, and additional examples.
Response
Body
application/json

