Documentation

Welcome to the face.com API (beta)!

Thanks for checking out face.com. We've opened up our APIs so that you can integrate our face detection and recognition technology with your apps and services. Whether you're looking to add tagging for photos, cool sci-fi experiences, or creative flavors to your apps, we're here to help.

In a nutshell:

  • We offer services for detecting, recognizing, and tagging faces in any photo, through our REST API
  • Face.com's services are offered for FREE with rate limits. Whitelisting is available.
  • You can tag and recognize users from Facebook or Twitter. Alternatively, you can train our index with your own set of users in a private namespace.
  • Saving Facebook and Twitter tags improves recognition for you and others, while maintaining your users' privacy.
  • We process photos from anywhere, so you can mix and match photo sources with user IDs, which could enable you to, say, recognize Facebook users in Flickr photos...

Privacy

When it comes to privacy we play nice, and we use Facebook/Twitter credentials to enforce friendly use where relevant. By "friendly" we mean that you can only tag or recognize your friends in social networks. We expect you to respect users' privacy - if you don't we will block your account without notice. Not sure if your use is okay? Check out our Terms of Use, shoot us a question on the forum, or contact us at privacy@face.com.

Getting Started

  1. Get your API Key, and agree to our Terms
  2. Check out the API sandbox, Code Example, and examples
  3. PHP and JS libs are available here. Got your own implementation? Let us know and we'll link to it.
  4. Start coding

More documentation? Start with these:

  • How Recognition Works
  • API methods
  • User IDs and Namespaces
  • Auth
  • Terms

Open Beta

Our free API is currently in beta stage, which means it's stable enough for public testing, but we might still have some quirks and bugs to iron out.

We'd love to hear what you think so we can make it even better. Our developer forum is the best place to start, or drop us a note through the contact form.

{
"photos":[
{
"url":"www.empireonline.com/images/features/100greatestcharacters/photos/84.jpg",
"pid":"93d87825bdd3018a1bab9b1016349b2b@F",
"width":355,
"height":400,
"tags":[
{
"subjectId":"",
"label":"",
"groupId":"",
"score":0,
"status":0,
"source":2,
"width":32.68,
"height":29,
"center":{"x":32.11,"y":25},
"eyeLeft":{"x":26.77,"y":21.77},
"eyeRight":{"x":38.42,"y":21.78},
"mouthLeft":{"x":29.86,"y":33.12},
"mouthCenter":{"x":32.38,"y":32.54},
"mouthRight":{"x":38.18,"y":32.92},
"nose":{"x":30.23,"y":26.77},
"yaw":-32.42,
"roll":0.05,
"pitch":15.64,
"attributes":{
"sex":{"value":"female","confidence":1},
"glasses":{"value":"true","confidence":95},
"smiling":{"value":"false","confidence":95}
}
}
]
}
],
"status":"success"
}
gipoco.com is neither affiliated with the authors of this page nor responsible for its contents. This is a safe-cache copy of the original web site.