Detector24
Back to Model Catalogue
Wanted Persons Detection
VideoFace / People Related

Wanted Persons Detection

Real-time face recognition in videos against Interpol, Europol, FBI and 52 country law enforcement databases

Accuracy
97.5%
Avg. Speed
5.0s
Per Request
$0.2500
API Name
wanted-person-detection

API Reference

Version
2601
Jan 3, 2026
Avg. Processing
5.0s
Per Request
$0.25
Required Plan
trial

Input Parameters

Detect wanted persons (Interpol Red/Yellow Notices) in video or batch images. Provide either video (video_url/base64_video) OR images (image_urls/base64_images), not both.

video_urlstring

URL of video to scan for wanted persons

Example:
https://example.com/video.mp4
base64_videostring

Base64-encoded video data (alternative to video_url)

image_urlsarray

Array of image URLs for batch processing

Example:
["https://example.com/1.jpg","https://example.com/2.jpg"]
base64_imagesarray

Array of base64-encoded images (alternative to image_urls)

fpsinteger

Frames per second to extract from video (1-10)

Example:
4
distance_thresholdfloat

Face matching distance threshold (0.3-0.7, lower = stricter)

Example:
0.5
extract_facesboolean

Extract cropped face PNG for best match of each person

Example:
true

Response Fields

Wanted person detection results with matches and processing statistics

matchesarray

Array of matched wanted persons

Array Item Properties:
matched_personobject

Information about the matched wanted person

best_matchobject

Details of the highest confidence detection

all_detectionsarray

All frames/images where this person was detected

occurrence_countinteger

Number of frames/images where person was detected

statsobject

Processing statistics

Object Properties:
input_typestring

Type of input (video or images)

items_processedinteger

Number of frames/images processed

faces_detectedinteger

Total faces detected across all frames/images

unique_matchesinteger

Number of unique wanted persons matched

processing_time_msinteger

Total processing time in milliseconds

Complete Example

Request

{
  "model": "wanted-person-detection",
  "video_url": "https://example.com/surveillance.mp4",
  "fps": 4,
  "distance_threshold": 0.5,
  "extract_faces": true
}

Response

{
  "inference_id": "inf_wpd_abc123def456",
  "model_id": "wanted_person_detection",
  "model_name": "Wanted Person Detection",
  "moderation_type": "video",
  "status": "completed",
  "result": {
    "matches": [
      {
        "matched_person": {
          "token": "face_xyz789",
          "name": "John Doe",
          "source": "wanted_persons",
          "metadata": {
            "nationalities": [
              "US"
            ],
            "date_of_birth": "1985-03-15",
            "gender": "male"
          }
        },
        "best_match": {
          "index": 24,
          "timestamp_ms": 6000,
          "bbox": {
            "x1": 150,
            "y1": 80,
            "x2": 280,
            "y2": 240
          },
          "det_score": 0.94,
          "distance": 0.18,
          "similarity": 0.82,
          "face_crop_png": "<base64-encoded-png>",
          "crop_width": 156,
          "crop_height": 192
        },
        "all_detections": [
          {
            "index": 20,
            "timestamp_ms": 5000,
            "bbox": {
              "x1": 145,
              "y1": 82,
              "x2": 275,
              "y2": 238
            },
            "det_score": 0.91,
            "distance": 0.22,
            "similarity": 0.78
          },
          {
            "index": 24,
            "timestamp_ms": 6000,
            "bbox": {
              "x1": 150,
              "y1": 80,
              "x2": 280,
              "y2": 240
            },
            "det_score": 0.94,
            "distance": 0.18,
            "similarity": 0.82
          },
          {
            "index": 28,
            "timestamp_ms": 7000,
            "bbox": {
              "x1": 160,
              "y1": 85,
              "x2": 290,
              "y2": 245
            },
            "det_score": 0.89,
            "distance": 0.25,
            "similarity": 0.75
          }
        ],
        "occurrence_count": 3
      }
    ],
    "stats": {
      "input_type": "video",
      "items_processed": 120,
      "faces_detected": 45,
      "unique_matches": 1,
      "processing_time_ms": 8500
    }
  },
  "response_time_ms": 8500,
  "created_at": "2026-02-01T10:53:23Z",
  "completed_at": "2026-02-01T10:53:31Z"
}

Additional Information

Rate Limiting
If we throttle your request, you will receive a 429 HTTP error code along with an error message. You should then retry with an exponential back-off strategy, meaning that you should retry after 4 seconds, then 8 seconds, then 16 seconds, etc.
Supported Formats
mp4, mov, avi, webm, mkv
Maximum File Size
100MB
Tags:face-recognitionwanted-personsinterpolsecuritylaw-enforcementwatchlist

Ready to get started?

Integrate Wanted Persons Detection into your application today with our easy-to-use API.

Learn more about video moderationBrowse all models