tineye-api

tineye-api

tineye-api is the official Node.js library for the TinEye API. The TinEye API is TinEye's paid reverse image search solution for professional, commercial or high-volume users. See https://api.tineye.com/ for more information.

Contents

• Installation
• Getting started
• Methods
  • Search using an image URL
  • Search using image data
  • Get remaining searches
  • Get number of indexed images
• Release history

Installation

Install the latest version of the library using npm:

$ npm install tineye-api

Getting started

After installation, require the library to start using it:

var TinEye = require('tineye-api')

Now that you've required the library, you can use it to create an instance of the API object.

var api = new TinEye('https://api.tineye.com/rest/', <public_key>, <private_key>);

Be sure to populate public_key and private_key with your own keys. You can test your code with our API sandbox keys, but you won't get real search results until you start using your real keys.

Once you have an api object, you can start searching. You can submit an image using either an image URL or by submitting image data by uploading an image file. You can also check the number of remaining searches in your account or check the number of images in the TinEye index.

Methods

Search using an image URL

var url = "https://tineye.com/images/meloncat.jpg";
var params = {
  offset: 0,
  limit: 10,
  sort: "score",
  order: "desc",
};
api
  .searchUrl(url, params)
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

Search using image data

var img = fs.readFileSync("/Users/Mypath/image.jpg");
var params = {
  offset: 0,
  limit: 10,
  sort: "size",
  order: "asc",
};
api
  .searchData(img, params)
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

Get remaining searches

api
  .remainingSearches()
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

Get number of indexed images

api
  .imageCount()
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

Release history

1.1.5

• Updated form-data 3.0.0 -> 4.0.0
• Updated jest 26.1.0 -> 27.0.1
• Fixed an encoding bug when searching with URLs

1.1.4

• Updated Axios 0.19.0 -> 0.21.1
• Fixed a bug when performing a search with no options

1.1.3

• Updated jest 25.1.0 -> 26.1.0

1.1.2

• Updated Axios 0.19.0 -> 0.19.2
• Updated form-data 2.5.0 -> 3.0.0
• Updated jest 24.8.0 -> 25.1.0
• Updated Sandbox key link in Readme
• Removed the tests from being packaged
• Removed unneeded git folder from .gitignore

1.1.0

• Changed tests from BusterJS to Jest
• Removed BlueBird and switched to native promises
• Switch library for making GET requests from Requests to Axios

1.0.2

• Switched hashing algorithm from SHA1 to SHA256
• Switched README from reStructuredText to Markdown

1.0.1

• Cleaning up some code and comments
• Some error handling fixes

1.0.0

• Adding promises
• Better error handling
• Switched method names to camelCasing
• searchUrl and searchData now take an option array

0.1.0

• Initial release