Find answers, guides, and resources to help you succeed
Learn the basics and start integrating
Detailed endpoint documentation
API keys and security best practices
Common issues and solutions
Get up and running with FaceHub API in minutes. This guide walks you through creating an account, obtaining your API key, and making your first API request.
curl -X POST https://api.facehub.cloud/v1/count \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"app":"myapp","url":"https://example.com/photo.jpg"}'Choose the right plan for your needs. We offer a generous free tier for development and testing, plus scalable pay-as-you-go options for production use.
Follow these best practices to get the most out of FaceHub API:
/v1/queueQueue multiple images for batch processing. Extracts faces, embeddings, and metadata.
Request Body:
{"app": "myapp", "tag": "optional-tag", "urls": ["url1", "url2"]}/v1/selfieSearch for images containing a specific person by providing a selfie.
Request Body:
{"app": "myapp", "url": "selfie_url", "threshold": 60}/v1/countCount the number of faces detected in an image.
Request Body:
{"app": "myapp", "url": "image_url"}All API requests require authentication using a Bearer token. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYSecurity Warning: Keep your API keys secure. Never commit them to version control or expose them in client-side code.
If you suspect your API key has been compromised, contact support to rotate it. Steps to rotate:
Cause: Invalid or missing API key
Solution:
Authorization: Bearer YOUR_KEYCause: Too many requests in a short time period
Solution:
Retry-After headerCause: Image quality or content issues
Solution:
Cause: Large image files or network issues
Solution:
Quick answers to common questions
Our face detection model achieves very high accuracy. Results depend on image quality, lighting conditions, face angles, and occlusion. Best results are achieved with well-lit, front-facing photos with minimal obstruction.
All standard image formats are supported including JPEG, PNG, WebP, GIF, TIFF, and more. Images are automatically converted and optimized during processing.
We never store your images. Images are processed in real-time and immediately discarded. Only face embeddings and metadata are stored permanently until your account is deleted or you request deletion by contacting support.
Yes! Both free and paid plans can be used for commercial applications. However, you must ensure compliance with GDPR and other applicable data protection regulations. You are responsible for obtaining necessary consents from individuals whose images you process. See our Terms & Conditions for details.
Currently, there are no rate limits on API requests. You can make as many requests as needed. Usage limits are based on your monthly image quota: Free tier includes 100 images per month, and Pay-as-you-go includes 10,000 images per month with additional images charged at €0.01 each.
You can upgrade to a paid plan anytime from the pricing page. To downgrade or cancel, contact support@parklolo.com. Changes take effect at the start of the next billing cycle. No refunds for partial months.
We provide a REST API that works with any HTTP client library in any programming language. There are no official SDKs - simply use standard HTTP libraries like axios (JavaScript), requests (Python), fetch (JavaScript), or curl (command line) to integrate our API into your application.
Free tier: API requests will return a 429 error once you reach 100 images. Pay-as-you-go: You'll be charged €0.01 per additional image beyond the 10,000 included. Contact support if you need to set spending limits.
Can't find what you're looking for? Our support team is here to help.