Reverse Face Search CLI

Face search from your terminal — built on the FaceSeek Face Search API.

A zero-dependency shell CLI that posts an image to the FaceSeek API and prints the matching source URLs and similarity scores.

How it works

This example sends a photo to the FaceSeek reverse face search API, which looks for the same face across the public web (not just an identical image file) and returns the matching source URLs with a similarity score.

Quick start

git clone https://github.com/faceseek-online/reverse-face-search-cli.git
cd reverse-face-search-cli
chmod +x facesearch.sh
export FACESEEK_API_KEY="fsk_your_key"
./facesearch.sh path/to/photo.jpg

Get a free API key at www.faceseek.online — free daily searches are included.

Learn more

• 📖 Guide: The Complete Reverse Face Search Guide
• 📚 API docs: https://www.faceseek.online/api-docs
• 🌐 FaceSeek: https://www.faceseek.online

License

MIT