Imagga API Technical Documentation

What is it?

Imagga API is a set of image analysis and understanding technologies available as web services that allow owners of large image collections to automate the process of analyzing, organizing and searching through the images inside their collections.

The services are hosted at our end and are available on a software-as-a-service (SaaS) basis which makes them very flexible, scalable (applicable to any size of image collection), and affordable.

How does it work?

Preliminary (one-time) steps

• The API users (the image collection owners) apply for an Imagga API account.
• Once approved, they receive API credentials and a thin Imagga API client.

Actual API usage

The API users integrate the API according to the following scheme:

• Every time users have some new image content to be processed (for example newly created, crowd-sourced or crawled images) they make an Imagga API call (via HTTP POST request), providing the image URLs.
• The Imagga API servers analyze these images and return the extracted image features (e.g. colors, division regions, image type, image class, etc.) and image metadata (e.g. tags) back to the API users.
• The API users typically store this information somewhere so they can later (or sometimes immediately) use it to enrich the functionality and improve the usability of the interface to their image collections or organise their collections better (by grouping, clustering the images), etc.

List of Imagga APIs

• Color Extraction and Multi-Color Search API
• Smart Cropping and Collage Slicing API
• Product vs. Scene Classification (not documented yet)
• Indoor vs. Outdoor Classification (not documented yet)
• Auto-Tagging (still in private beta)