Metadata-Version: 2.4
Name: faceseek
Version: 1.0.0
Summary: Official Python client for the FaceSeek reverse face search API.
Author: FaceSeek
License: MIT
Project-URL: Homepage, https://www.faceseek.online
Project-URL: Documentation, https://www.faceseek.online/api-docs
Project-URL: Source, https://github.com/faceseek-online/faceseek-python
Keywords: face search,reverse image search,osint,facial recognition,api,face recognition
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25
Dynamic: license-file

# FaceSeek — Python SDK

Official Python client for the [FaceSeek](https://www.faceseek.online) reverse
face search API. Find where a face appears across the public web.

```bash
pip install faceseek
```

## Usage

```python
from faceseek import FaceSeek

fs = FaceSeek(api_key="fsk_...")          # or set FACESEEK_API_KEY

# Reverse face search
for match in fs.search("photo.jpg"):
    print(match["source_url"], match["score"])

# Check your balance
print(fs.account())   # {"email": ..., "credits_remaining": ...}
```

`search()` accepts a file path or a binary file-like object and returns a list
of matches (`source_url`, `score`, and more).

## Get an API key

Sign up free at [faceseek.online](https://www.faceseek.online) — free daily
searches included. Full API reference: [/api-docs](https://www.faceseek.online/api-docs).

## License

MIT
