Akator Image Matcher Documentation
Akator Image Matcher is an API for detecting duplicate and modified images in your platform's user uploads. It helps you comply with EU copyright law's stay-down obligations (Article 17 / UrhDaG).
How It Works
The API uses advanced image fingerprinting to find matches between user uploads and your blocklist of reported images. It detects images even when they've been:
- Resized or scaled
- Cropped
- Rotated (90°, 180°, 270°)
- Mirrored horizontally or vertically
- Color-adjusted or filtered
- Compressed or converted to different formats
Quick Start
Getting started with Akator Image Matcher involves three steps:
- Get your API key — Contact us to receive your API credentials.
- Create a collection — Collections hold your blocklist of reported images.
- Integrate the match endpoint — Check user uploads against your blocklist.
Core Concepts
Collections
Collections are containers for your images. Typically, you'd create one collection per use case (e.g., "copyright-blocklist" or "reported-content"). Each collection is independent and can be searched separately.
Images
Images are added to collections when rightsholders report copyright infringements. The API creates a fingerprint for each image, which is used for matching.
Matching
When a user uploads content to your platform, you send the image to our match endpoint. The API compares it against all images in your collection and returns any matches with similarity scores.
API Base URL
https://matching.akator.de/api/v1.1Interactive API documentation (Swagger UI) is available at matching.akator.de/api/v1.1/docs .
Authentication
All API requests require authentication via Bearer token in the Authorization header:
Authorization: Bearer your_api_key