Get started

# API Endpoint
https://api.appducks.com/
          

We are helping developers deliver low-friction, state-of-the-art pattern recognition, link and behavior analysis, and OCR solution with just a single API call. Our mission is to leverage AI and Blockchain technologies to streamline the KYC process, reduce cost and customer friction, and make running KYC seamless for everyone. No machine learning expertise is required to build your next future intelligent application for your customers.

No API key is required. We accept only cups of coffee to help us keep awake and improve/add new APIs and maintain our resources. Thanks for supporting us


Buy us a coffeeBuy us a coffee

Face Matching


# API Endpoint
https://api.appducks.com/face/matcher

# Sample Request
curl 'https://api.appducks.com/face/matcher' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data 'face1=[FACE1_URL]&face2=[FACE2_URL]'
                    

To compare two faces, make a POST call to the following url :
https://api.appducks.com/face/matcher



# Request Body:
{
  face1:"https://i.imgur.com/bvT91HG.jpg",
  face2:"https://i.imgur.com/MMcxImK.jpg"
}

# Response Example:
{
  distance: 0.4584291735678101,
  success: true
}

# Request Error
{
  error: "error message xxxxxxx xxxxxx",
  success: false
}
                    

Request Body Fields

Field Type Description
face1 string image URL. e.g. https://i.imgur.com/bvT91HG.jpg
face2 string image URL. e.g. https://i.imgur.com/MMcxImK.jpg

Response Fields

Field Type Description
distance float/number between 0 and 1. How closer the images to one another. You can set a threshold of your choice to define how identical the two faces are. We recommend 0.6 as threshold. But you can consider less number if you want to be more restricted in intolerant
success boolean true: the request is succeeded. false: unsuccessful request.
error string error message when having unsuccessful request.

Use Cases

Here are some, but not all, use cases, I believe you have a lot in mind.

  • KYC: you can compare a selfie with ID photos to make sure they are who they say they are.
  • Dating Apps: you can create smart matching.
  • Fun Apps: you can, for example, show user a celebrity they are very similar to in appearance.
  • Family Apps: you can check whether your're more similar to your mom or dad.
  • Many more ....

Passport doc ocr


# API Endpoint
  https://api.appducks.com/ocr/passport

# Sample Request
curl 'https://api.appducks.com/ocr/passport' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data 'image=[PASSPORT_IMAGE]'
                              

to scan passport document, make a POST call to the following url :
https://api.appducks.com/ocr/passport


# Request Body:
{
  image:"https://i.imgur.com/uGjALtm.png"
}

# Response Example:
{
  result: {
  name: "CHIN YONGHE",
  country: { "name": "China","code": "CHN"},
  passportNo: ["G2222888","N6311283","M1708130"],
  dates: ["28 NOV 1963","12 DEC 2007","13 AUG 2017"]
  },
  fullText: "xxxxxxxx xxxxxx", 
  success : true 
}
          

Request Body Fields

Field Type Description
image string passport image URL. e.g. https://i.imgur.com/uGjALtm.png

Response Fields

Field Type Description
result object contains the main contents of any passport: passportNo, name, country, dates
success boolean true: the request is succeeded. false: unsuccessful request.
fullText string contains all the contents of the passport in an unformatted way.
error string error message when having unsuccessful request.

Use Cases

Here are some, but not all, use cases, I believe you have a lot in mind.

  • Know Your Customer
  • Governmental/legal Apps
  • Banking/Finance Apps
  • Smart Flight Check-in
  • Many More ...

Upload Image


# API Endpoint
  https://api.appducks.com/image/upload

# Sample Request
curl -F 'image=[IMAGE_LOCAL_PATH]' https://api.appducks.com/image/upload
          

This endpoint is for uploading images in case you don't want to do any image uploading on your own server (we provided this endpoint for convenience and quick testing but we always encourage you to upload your images in your own server when you move to production env).

To upload image, make a POST call to the following url :
https://api.appducks.com/image/upload


# Response Example:
{
  success: true,
  image:"https://image_url"
}

# Request Error
{
  error: "error message xxxxxxx xxxxxx",
  success: false
}
                              

Request Body Fields

Field Type Description
image File (multipart/form-data) Image file

Response Fields

Field Type Description
image string Image URL
success boolean true: the request is succeeded. false: unsuccessful request.
error string error message when having unsuccessful request.

note: /image/upload endpoint is designed only for testing purposes. We do not recommend using it for your production as we wipe up all images every now and then. However, If you would like to use it for production, please email us so we can help you out.

Work in progress

# API Endpoint
 would be available soon
          

We are working on identifying the authenticity of driver's license (taking Florida DL as our data to train). There are a few aspects we are currently taking in considerations:

Security Features

Font Verification

Pixel Tampering

Image Manipulation Detection