Face Detection

Detect faces in images with bounding boxes, landmarks, and confidence scores. Supports MediaPipe and Azure Vision backends.

Features

• Fast Processing: Lightning-fast face detection powered by Azure
• Reliable: 99.9% uptime with automatic failover
• Scalable: Handle single requests or bulk operations
• Secure: Enterprise-grade security with API key authentication
• Well Documented: Comprehensive API documentation and examples

Use Cases

• E-commerce: Process product images at scale
• Media: Automate image processing pipelines
• Apps: Add image processing to your applications

Input Parameters

Parameter	Type	Required	Description
imageUrl	string	No	URL of the image to analyze
imageUrls	array	No	Array of image URLs for batch processing
includeLandmarks	boolean	No	Include facial landmark positions
minConfidence	number	No	Minimum detection confidence (0-1)
backend	string	No	Detection backend to use

Output Format

{
  "success": true,
  "result": { ... },
  "timestamp": "2026-01-07T00:00:00Z"
}

Code Examples

JavaScript (Node.js)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const input = {
  "imageUrl": "example_imageUrl",
  "imageUrls": [],
  "includeLandmarks": true,
  "minConfidence": 0.5,
  "backend": "auto"
};

const run = await client.actor("vivid_astronaut/face-detection").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
  "imageUrl": "example_imageUrl",
  "imageUrls": [],
  "includeLandmarks": true,
  "minConfidence": 0.5,
  "backend": "auto"
}

run = client.actor("vivid_astronaut/face-detection").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

cURL

curl -X POST "https://api.apify.com/v2/acts/vivid_astronaut~face-detection/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "imageUrl": "example_imageUrl",
  "imageUrls": [],
  "includeLandmarks": true,
  "minConfidence": 0.5,
  "backend": "auto"
}'

Pricing

Model: Pay per result Price: $0.020 per result

You only pay for successful results. Platform usage costs are included.

API Documentation

Full API documentation is available at:

• Apify API Reference
• Actor API Endpoints

Support

• Issues: Report bugs via Apify Console
• Documentation: Apify Docs
• Community: Apify Discord

Version History

See ./CHANGELOG.md for version history.

---

Powered by Azure Cloud Infrastructure