Imagga

FREE
By raygorodskij
Updated 5 months ago
Machine Learning
-/10
Popularity Score
-
Latency
-
Success Rate

Imagga API Overview

The Imagga API is a set of image understanding and analysis technologies available as a web service that allows you to automate the process of analyzing, organizing and searching through large collections of unstructured images.

Contact API Provider
star-blueRate

Imagga

Imagga Package

The Imagga API is a set of image understanding and analysis technologies available as a web service that allows you to automate the process of analyzing, organizing and searching through large collections of unstructured images.

How to get credentials:

  1. Register on imagga.com.
  2. After creation your account you will see api Secret and api Key.

Imagga.tagImageById

By sending image content id to the tagImageById endpoint you can get a list of many automatically suggested textual tags.

Field Type Description
contentId List You can also directly send image files for auto-tagging by uploading them to our uploadImage endpoint and then providing the received content identifiers via this parameter.You can provide up to 5 id.
showTagInformation Select Whether to return some additional information about each of the tags or not.
language List All list here.You can apply this parameter multiple times.Example - en.
limit Number Limits the number of tags in the result to the number you set.
key credentials API key.
secret credentials API secret.

Imagga.tagImageByUrl

By sending image url to the tagImageByUrl endpoint you can get a list of many automatically suggested textual tags.

Field Type Description
imageUrl List Image URL to perform auto-tagging on. You can provide up to 5 urls for processing by sending multiple url parameters.
showTagInformation Select Whether to return some additional information about each of the tags or not.
language List All list here.You can apply this parameter multiple times.Example - en.
limit Number Limits the number of tags in the result to the number you set.
key credentials API key.
secret credentials API secret.

Imagga.getAllCategorizers

Get a list of all available categorizers for you.

Field Type Description
key credentials API key.
secret credentials API secret.

Imagga.uploadImage

Using the uploadImage endpoint you can upload a file (image or video) for processing by one of the other Imagga API endpoint.

Field Type Description
key credentials API key.
secret credentials API secret.
imageFile File Uploaded image.

Imagga.deleteImage

Delete an uploaded file.

Field Type Description
key credentials API key.
secret credentials API secret.
contentId String Image content id.Obtained with uploadImage endpoits.

Imagga.getImageCategoriesByUrl

By sending image url and categorizerId from getAllCategoriez endpoint to this endpoint you can get a list of many categorizers.

Field Type Description
key credentials API key.
secret credentials API secret.
categorizerId String The categorizer id.
imageUrl List URL of an image to submit for categorization. You can provide up to 10 urls for processing by sending multiple url parameters.
language List All list here.You can apply this parameter multiple times.Example - en.

Imagga.getImageCategoriesById

By sending image content id and categorizerId from getAllCategoriez endpoint to this endpoint you can get a list of many categorizers.

Field Type Description
key credentials API key.
secret credentials API secret.
categorizerId String The categorizer id.
contentId List You can also directly send image files for categorization by uploading the images to our uploadImage endpoint.Example - en.
language List All list here.You can apply this parameter multiple times.

Imagga.getCropOptionsByUrl

The technology behind this endpoint analyzes the pixel content of each given image url in order to find the most “visually important” areas in the image.

Field Type Description
key credentials API key.
secret credentials API secret.
imageUrl List A URL of the image to send for smart-cropping analysis. You can provide as many url parameters as you like in order to send multiple images for smart-cropping analysis.
resolutionPair List Resolution pair in the form (width)x(height) where ‘x’ is just the small letter x. You can provide several resolutions just by providing several resolution parameters as with the urls.
scaling Select Whether the cropping coordinates should exactly match the requested resolutions or just preserve their aspect ratios and let you resize the cropped image later.

Imagga.getCropOptionsById

The technology behind this endpoint analyzes the pixel content of each given image content id in order to find the most “visually important” areas in the image.

Field Type Description
key credentials API key.
secret credentials API secret.
contentId List You can also directly send image files for smart-cropping analysis by uploading them to our /content endpoint and then providing the received content identifier via this parameter.
resolutionPair List Resolution pair in the form (width)x(height) where ‘x’ is just the small letter x. You can provide several resolutions just by providing several resolution parameters as with the urls.
scaling Select Whether the cropping coordinates should exactly match the requested resolutions or just preserve their aspect ratios and let you resize the cropped image later.

Imagga.getImageColorExtractionByUrl

Analyse and extract the predominant colors from one or several url images.

Field Type Description
key credentials API key.
secret credentials API secret.
imageUrl List Image URL to perform color extraction on. You can provide as many url parameters as you like in order to send multiple images for color extraction.
extractOverallColors Select Specify whether the overall image colors should be extracted.
extractObjectColors Select Specify if the service should try to extract object and non-object (a.k.a. foreground and background) colors separately.

Imagga.getImageColorExtractionById

Analyse and extract the predominant colors from one or several images content id.

Field Type Description
key credentials API key.
secret credentials API secret.
contentId List You can also send actual image files for color extraction. This is achieved by uploading the images to our uploadImage endpoint.You can provide up to 10 ids.
extractOverallColors Select Specify whether the overall image colors should be extracted.
extractObjectColors Select Specify if the service should try to extract object and non-object (a.k.a. foreground and background) colors separately.

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.post("https://ImaggaraygorodskijV1.p.rapidapi.com/deleteImage")
.header("X-RapidAPI-Host", "ImaggaraygorodskijV1.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("Content-Type", "application/x-www-form-urlencoded")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication