API Doc-Image Recognition/Matching API

API Summery :

Image Recognition/Matching API provides a service to find a match image in a client's image set for an input image. Image finger print characteristics such as color distribution, shape geometry, and image features are used for matching. Thank to our advanced image matching technology, our service has a great ability to resist noise of input image such as scaling, lighting change, rotating, and interference of background. Image Recognition/Matching API is a great service for applications of online shopping websites, eCommerce mobile Apps for offline & online interactions thus to bring offline shoppers to online for more transactions.

Image Recognition/Matching Features:

Application scene :

image database trading platform, picture material website, picture community website, picture sharing APP

API end point : http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search

Image format requirement: JPG format, image width and length each for 300 – 800 pix

Http method : POST

Request Parameters:(body) :

Parameter Name	Type	Required	Parameter Location	Description	Default Value
apikey	string	Yes	header	API Key	None
catid	No	No	header	Category ID (1 – 3000 integer)	0 (means all categories)
lang	string	No	header	Language: zh - Chinese; en - English	zh - Chinese
fmt	string	No	header	Response format: json or xml	json
subject	int	No	header	input keywords, used for image + keywords hybrid search	None
labeland	string	No	header	AND logic labels for input image, positive integer,Example:65,58,408	None
labelor	string	No	header	OR logic labels for input image,positive integer,Example:305,38,5	None
labelnot	string	No	header	NOT logic labels for input image,positive integer,Example:345,368,45	None
p	string	No	body	The pth page shows the pth page, p is greater than or equal to 1 positive integer	1
numperpage	string	No	body	Show how many pages per page, should be a positive integer	16
maxitems	string	No	body	A total of how many show a total show, should be a positive integer	200

Request Parameters(body) :

Parameter Name	Type	Required	Parameter Location	Description	Default Value
photo	file	Yes	body	Image for uploading	None

														
Curl Example1:
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search' -v -F photo=@dog1.jpg -F apikey=your apikey
														
Above Curl request upload an image dog1.jpg, search for matching images, by using your apikey, values of other parameters are as default
														
Curl Example2:
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search' -v -F photo=@dog1.jpg -F apikey=your apikey -F subject=pet -F catid=45 -F labeland=345,356 -F labelnot=98   
														
Above Curl request upload an image dog1.jpg, search for matching images, by using your apikey, search for similar images with keyword “pet”, image category as 45, and result images have labels 345 and 356, but without label 98.  Values of other parameters are as default

import java.io.File;
import java.io.IOException;
import java.nio.charset.Charset;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiPnpSearch {
	public static final String DEF_CHATSET = "UTF-8";
    public static final int DEF_CONN_TIMEOUT = 3000;
    public static final int DEF_READ_TIMEOUT = 3000;
    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
    public static final String APPKEY ="*******************************_3";
    public static final String LANG ="zh";
    public static final String FMT ="json";
    
	public static String pnpSearchByImg(File file,int  catid ,String subject,String labeland,String labelor,String labelnot) throws IOException{
			CloseableHttpClient httpClient = HttpClients.createDefault();
	        CloseableHttpResponse response = null;
	        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
	        String result =null;
	        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
	        try {
	            HttpPost httppost = new HttpPost("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search");
	            FileBody bin = new FileBody(file);
	            StringBody catidBody = new StringBody(catid+"" , contentType);
	            StringBody keyBody = new StringBody(APPKEY , contentType);
	            StringBody langBody = new StringBody(LANG , contentType);
	            StringBody fmtBody = new StringBody(FMT , contentType);
	            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
	            builder.addPart("apikey", keyBody)
	            .addPart("photo", bin)
	            .addPart("catid", catidBody)
	            .addPart("lang", langBody)
	            .addPart("fmt", fmtBody);
	             if(subject != null && subject.isEmpty() == false){
	            	 StringBody subjectBody = new StringBody(subject, Charset.forName("UTF-8"));
	            	 builder.addPart("subject", subjectBody);
	             } 
	             if(labeland != null && labeland.isEmpty() == false){
	            	 StringBody labelandBody = new StringBody(labeland , contentType);
	            	 builder .addPart("labeland", labelandBody);
	             }
	             if(labelor != null && labelor.isEmpty() == false){
	            	 StringBody labelorBody = new StringBody(labelor , contentType);
	            	 builder .addPart("labelor", labelorBody);
	             }
	             if(labelnot != null && labelnot.isEmpty() == false){
	            	 StringBody labelnotBody = new StringBody(labelnot , contentType);
	            	 builder .addPart("labelnot", labelnotBody);
	             }
	            HttpEntity reqEntity =  builder.build();
	            httppost.setEntity(reqEntity);
	            response = httpClient.execute(httppost);
	            HttpEntity resEntity = response.getEntity();
	            if (resEntity != null) {
	               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
	                String charset = "UTF-8";   
	  			  String content=EntityUtils.toString(response.getEntity(), charset);   
	                System.out.println(content);
	            }
	            EntityUtils.consume(resEntity);
	        }catch(Exception e){
	            e.printStackTrace();
	        }finally {
	            response.close();
	            httpClient.close();
	        }
	        return result;
		}
	
	public static void main(String[] args) {
		try {
			pnpSearchByImg(new File("/path/dog1.jpg"),0,null,null,null,null);
			/*Above request upload an image dog1.jpg, search for matching images, by using your apikey, values of other parameters are as default  */	
			pnpSearchByImg(new File("/path/dog1.jpg"),45,"pet","345,356",null,"98");
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
	
}

# test_client.py
import urllib2_file
import urllib2

data = {
		'apikey': '**********************************_3',
        'photo':  open('/path/dog1.jpg'),
        'catid':'0',
        'subject':'',
        'labeland':'',
        'labelor':'',
        'labelnot':''
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search', data)
content = f.read()
print(content)

#Above request upload an image dog1.jpg, search for matching images, by using your apikey, values of other parameters are as default  												 	
data = {
		'apikey': '**********************************_3',
        'photo':  open('/path/dog1.jpg'),
        'catid':'45',
        'subject':'pet',
        'labeland':'345,356',
        'labelor':'',
        'labelnot':'98'
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search', data)
content = f.read()
print(content)


require 'vendor/autoload.php';
use GuzzleHttp\Client;

$apikey = '*************';
$catid = '0';
$subject = '';
$labeland = '';
$labelor = '';
$labelnot = '';
$filebody = fopen('/path/dog1.jpg', 'r');
$client = new GuzzleHttp\Client(['base_uri' => 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search']);
$response = $client->request('POST',  'apipnp_search', [
    'multipart' => [
	        [
	            'name'     => 'apikey',
	            'contents' => $apikey,
	        ],
	        [
	            'name'     => 'catid',
	            'contents' => $catid,
	        ],
	        [
	            'name'     => 'photo',
	            'contents' => $filebody
	        ],
			[
	             'name'=> 'subject',
	            'contents' => $subject 
		    ], 
			[
	             'name'=> 'labeland',
	            'contents' => $labeland 
	        ],
			[
	             'name'=> 'labelor',
	            'contents' => $labelor 
	        ],
			[
	             'name'=> 'labelnot',
	            'contents' => $labelnot 
	        ]
	    ]
]);

$rbody = $response->getBody();
echo $rbody;
#Above request upload an image dog1.jpg, search for matching images, by using your apikey, values of other parameters are as default

require 'vendor/autoload.php';
use GuzzleHttp\Client;

$apikey = '*************';
$catid = '45';
$subject = 'pet';
$labeland = '345,356';
$labelor = '';
$labelnot = '98';
$filebody = fopen('/path/dog1.jpg', 'r');
$client = new GuzzleHttp\Client(['base_uri' => 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search']);
$response = $client->request('POST',  'apipnp_search', [
    'multipart' => [
	        [
	            'name'     => 'apikey',
	            'contents' => $apikey,
	        ],
	        [
	            'name'     => 'catid',
	            'contents' => $catid,
	        ],
	        [
	            'name'     => 'photo',
	            'contents' => $filebody
	        ],
			[
	             'name'=> 'subject',
	            'contents' => $subject 
		    ], 
			[
	             'name'=> 'labeland',
	            'contents' => $labeland 
	        ],
			[
	             'name'=> 'labelor',
	            'contents' => $labelor 
	        ],
			[
	             'name'=> 'labelnot',
	            'contents' => $labelnot 
	        ]
	    ]
]);

$rbody = $response->getBody();
echo $rbody;

Detailed use of tutorials

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
  
        public static string HttpUploadFile(string url, string file, string paramName, string contentType, NameValueCollection nvc)
        {
            string result = string.Empty;
            string boundary = "---------------------------" + DateTime.Now.Ticks.ToString("x");
            byte[] boundarybytes = System.Text.Encoding.ASCII.GetBytes("\r\n--" + boundary + "\r\n");

            HttpWebRequest wr = (HttpWebRequest)WebRequest.Create(url);
            wr.ContentType = "multipart/form-data; boundary=" + boundary;
            wr.Method = "POST";
            wr.KeepAlive = true;
            wr.Credentials = System.Net.CredentialCache.DefaultCredentials;

            Stream rs = wr.GetRequestStream();

            string formdataTemplate = "Content-Disposition: form-data; name=\"{0}\"\r\n\r\n{1}";
            foreach (string key in nvc.Keys)
            {
                rs.Write(boundarybytes, 0, boundarybytes.Length);
                string formitem = string.Format(formdataTemplate, key, nvc[key]);
                byte[] formitembytes = System.Text.Encoding.UTF8.GetBytes(formitem);
                rs.Write(formitembytes, 0, formitembytes.Length);
            }
            rs.Write(boundarybytes, 0, boundarybytes.Length);

            string headerTemplate = "Content-Disposition: form-data; name=\"{0}\"; filename=\"{1}\"\r\nContent-Type: {2}\r\n\r\n";
            string header = string.Format(headerTemplate, paramName, file, contentType);
            byte[] headerbytes = System.Text.Encoding.UTF8.GetBytes(header);
            rs.Write(headerbytes, 0, headerbytes.Length);

            FileStream fileStream = new FileStream(file, FileMode.Open, FileAccess.Read);
            byte[] buffer = new byte[4096];
            int bytesRead = 0;
            while ((bytesRead = fileStream.Read(buffer, 0, buffer.Length)) != 0)
            {
                rs.Write(buffer, 0, bytesRead);
            }
            fileStream.Close();

            byte[] trailer = System.Text.Encoding.ASCII.GetBytes("\r\n--" + boundary + "--\r\n");
            rs.Write(trailer, 0, trailer.Length);
            rs.Close();

            WebResponse wresp = null;
            try
            {
                wresp = wr.GetResponse();
                Stream stream2 = wresp.GetResponseStream();
                StreamReader reader2 = new StreamReader(stream2);

                result = reader2.ReadToEnd();
            }
            catch (Exception ex)
            {
                if (wresp != null)
                {
                    wresp.Close();
                    wresp = null;
                }
            }
            finally
            {
                wr = null;
            }

            return result;
        }
        static void Main(string[] args)
            {
            NameValueCollection nvc = new NameValueCollection();
            nvc.Add("apikey", "**************");
            nvc.Add("catid", "0");
            nvc.Add("fmt", "json");
            String s =  HttpUploadFile("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search", "/path/dog1.jpg", "photo", "image/jpeg", nvc);
            Console.WriteLine(s);
            Console.ReadKey();
            //Above request upload an image dog1.jpg, search for matching images, by using your apikey, values of other parameters are as default
            

            NameValueCollection nvc1 = new NameValueCollection();
            nvc1.Add("apikey", "**************");
            nvc1.Add("catid", "45");
            nvc1.Add("fmt", "json");
            nvc1.Add("subject", "pet");
            nvc1.Add("labeland", "345,356");
            nvc1.Add("labelnot", "98");
            String s1 =  HttpUploadFile("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search", "/path/dog1.jpg", "photo", "image/jpeg", nvc1);
            Console.WriteLine(s1);
            Console.ReadKey();
         }
        }
}

JSON Response Example:

{ resultList": [ { "class":"vs.vscommon.ImageSearchResultEntry", "imgName":"1392125321.jpg", "imgRelativePath":"0_All/41_xyz/0_All_Categories/227_e2/1392125321.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/e2/04/1392125321.jpg", "info":null, "keyword":"Study,Signature", "productPageUrl":"http://www.xyz.cn/r/photo/view/id/1392125321/", "score":0.9785203, "tagsList":null, "title":"Gold pen signing contract" }, { "class":"vs.vscommon.ImageSearchResultEntry", "imgName":"1204325791.jpg", "imgRelativePath":"0_All/41_xyz/0_All_Categories/53_34/1204325791.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/34/ce/1204325791.jpg", "info":null, "keyword":"white,animal,local", "productPageUrl":"http://www.xyz.cn/r/photo/view/id/1204325791/", "score":0.978022, "tagsList":null, "title":"Small fish in glass of water isolated"} ] }

API end point: http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search

Image format requirement: JPG format, image width and length each for 300 – 800 pix

Http method : POST

Request Parameters(body) :

Parameter Name	Type	Required	Parameter Location	Description	Default Value
apikey	string	Yes	header	API Key	None
imgurl	string	Yes	header	Image URL	None
catid	No	No	header	Category ID (1 – 3000 integer)	0 (means all categories)
lang	string	No	header	Language: zh - Chinese; en - English	zh - Chinese
fmt	string	No	header	Response format: json or xml	json
subject	int	No	header	input keywords, used for image + keywords hybrid search	None
labeland	string	No	header	AND logic labels for input image, positive integer,Example:65,58,408	None
labelor	string	No	header	OR logic labels for input image,positive integer,Example:305,38,5	None
labelnot	string	No	header	NOT logic labels for input image,positive integer,Example:345,368,45	None
p	string	No	body	The pth page shows the pth page, p is greater than or equal to 1 positive integer	1
numperpage	string	No	body	Show how many pages per page, should be a positive integer	16
maxitems	string	No	body	A total of how many show a total show, should be a positive integer	200

													
Curl Demo1:
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search' -v -F apikey=your apikey -F imgurl =http://www.xyz.com/img/dog1.jpg    
													
Above Curl request is to search visually similar images by using an input image located at image URL http://www.xyz.com/img/dog1.jpg, by using your apikey, values of other parameters as default.

import java.io.IOException;
import java.nio.charset.Charset;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiPnpSearch {

	public static final String DEF_CHATSET = "UTF-8";
    public static final int DEF_CONN_TIMEOUT = 3000;
    public static final int DEF_READ_TIMEOUT = 3000;
    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
    public static final String APPKEY ="*******************************_3";//APIKEY
    public static final String LANG ="zh";
    public static final String FMT ="json";
    
	public static String pnpSearchByImgURL(int  catid ,String imgurl) throws IOException{
		CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse response = null;
        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
        String result =null;
        try {
            HttpPost httppost = new HttpPost("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search");
            StringBody catidBody = new StringBody(catid+"" , contentType);
            StringBody keyBody = new StringBody(APPKEY , contentType);
            StringBody langBody = new StringBody(LANG , contentType);
            StringBody fmtBody = new StringBody(FMT , contentType);
            StringBody imgurlBody = new StringBody(imgurl , contentType);
            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
            builder.addPart("apikey", keyBody).addPart("catid", catidBody)
            .addPart("lang", langBody)
            .addPart("fmt", fmtBody)
            .addPart("imgurl", imgurlBody);
            HttpEntity reqEntity =  builder.build();
            httppost.setEntity(reqEntity);
            response = httpClient.execute(httppost);
            HttpEntity resEntity = response.getEntity();
            if (resEntity != null) {
               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
                String charset = "UTF-8";   
  			  String content=EntityUtils.toString(response.getEntity(), charset);   
                System.out.println(content);
            }
            EntityUtils.consume(resEntity);
        }catch(Exception e){
            e.printStackTrace();
        }finally {
            response.close();
            httpClient.close();
        }
        return result;
	}
	
	public static void main(String[] args) {
		try {
			simSearchByImgURL(0,"http://www.xyz.com/img/dog1.jpg");
			/*Above request is to search visually similar images by using an input image located at image URL http://www.xyz.com/img/dog1.jpg, by using your apikey, values of other parameters as default.  */	
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

# test_client.py
import urllib2_file
import urllib2

data = {
		'apikey': '**********************************_3',
        'imgurl' : "http://www.xyz.com/img/dog1.jpg",
         'catid','0',
        'subject':'',
        'labeland':'',
        'labelor':'',
        'labelnot':''
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search', data)
content = f.read()
print(content)

#Above request is to search visually similar images by using an input image located at image URL http://www.xyz.com/img/dog1.jpg, by using your apikey, values of other parameters as default.

 $query = array(
      "imgurl" => "http://www.xyz.com/img/dog1.jpg",//
      "apikey" => "********************************_3"//APP Key
  );
  $result = post2("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search",$query);
  echo($result);

 function post2($url, $data){//file_get_content
         
        $postdata = http_build_query(
            $data
        );
 
        $opts = array('http' =>
 
                      array(
                          'method'  => 'POST',
                          'header'  => 'Content-type: application/x-www-form-urlencoded',
                          'content' => $postdata,
                      )
 
        );
 
        $context = stream_context_create($opts);
        $result = file_get_contents($url, false, $context);
        return $result;
    }    

#Above request is to search visually similar images by using an input image located at image URL http://www.xyz.com/img/dog1.jpg, by using your apikey, values of other parameters as default.

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
    public class HttpWebResponseUtility
    {
        private static readonly string DefaultUserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)";
        
        public static HttpWebResponse CreatePostHttpResponse(string url, IDictionary<string, string> parameters, int? timeout,string path, string userAgent, Encoding requestEncoding, CookieCollection cookies)
        {
            if (string.IsNullOrEmpty(url))
            {
                throw new ArgumentNullException("url");
            }
            if (requestEncoding == null)
            {
                throw new ArgumentNullException("requestEncoding");
            }
            HttpWebRequest request = null;
           
            if (url.StartsWith("https", StringComparison.OrdinalIgnoreCase))
            {
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
                request = WebRequest.Create(url) as HttpWebRequest;
                request.ProtocolVersion = HttpVersion.Version10;
            }
            else
            {
                request = WebRequest.Create(url) as HttpWebRequest;
            }
            request.Method = "POST";
            request.ContentType = "application/x-www-form-urlencoded";

            if (!string.IsNullOrEmpty(userAgent))
            {
                request.UserAgent = userAgent;
            }
            else
            {
                request.UserAgent = DefaultUserAgent;
            }

            if (timeout.HasValue)
            {
                request.Timeout = timeout.Value;
            }
            if (cookies != null)
            {
                request.CookieContainer = new CookieContainer();
                request.CookieContainer.Add(cookies);
            }

            Stream stream = request.GetRequestStream();
            if (path != null) 
            { 
                FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read);
                byte[] bArr = new byte[fs.Length];
                fs.Read(bArr, 0, bArr.Length);
                fs.Close();
               stream.Write(bArr, 0, bArr.Length);
            
            }
            
            if (!(parameters == null || parameters.Count == 0))
            {
                StringBuilder buffer = new StringBuilder();
                int i = 0;
                foreach (string key in parameters.Keys)
                {
                    if (i > 0)
                    {
                        buffer.AppendFormat("&{0}={1}", key, parameters[key]);
                    }
                    else
                    {
                        buffer.AppendFormat("{0}={1}", key, parameters[key]);
                    }
                    i++;
                }
                byte[] data = requestEncoding.GetBytes(buffer.ToString());
                stream.Write(data, 0, data.Length);
            
            }
            return request.GetResponse() as HttpWebResponse;
        }
       
        static void Main(string[] args)
        {
            string url = "http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_search";
            IDictionary<string, string> parameters = new Dictionary<string, string>();
            parameters.Add("apikey", "**************");
            parameters.Add("catid", "0");
            parameters.Add("fmt", "json");
            parameters.Add("imgurl", "http://www.wozhitu.com/static/images/test/dog1.jpg");
            HttpWebResponse response = HttpWebResponseUtility.CreatePostHttpResponse(url, parameters, null, null, null, Encoding.UTF8, null);
            StringBuilder content = new StringBuilder();
            Stream responseStream = response.GetResponseStream();
            StreamReader sReader = new StreamReader(responseStream, Encoding.GetEncoding("utf-8"));
            Char[] sReaderBuffer = new Char[256];
            int count = sReader.Read(sReaderBuffer, 0, 256);
            while (count > 0)
            {
                String tempStr = new String(sReaderBuffer, 0, count);
                content.Append(tempStr);
                count = sReader.Read(sReaderBuffer, 0, 256);
            }
            sReader.Close();
            Console.WriteLine(content.ToString());
            Console.ReadKey(); 
            //Above request is to search visually similar images by using an input image located at image URL http://www.xyz.com/img/dog1.jpg, by using your apikey, values of other parameters as default.  
         }
        }
}

JSON Response Example :

{ resultList":[{"class":"vs.vscommon.ImageSearchResultEntry","imgName":"1392125321.jpg", "imgRelativePath":"0_All/41_xyz/0_All_Categories/227_e2/1392125321.jpg","imgUrl": "http://www.xyz.cn/images/front/v/pic2/e2/04/1392125321.jpg","info":null,"keyword": "Study,Signature","productPageUrl":"http://www.xyz.cn/r/photo/view/id/1392125321/", "score":0.9785203,"tagsList":null,"title":"Gold pen signing contract"},{"class": "vs.vscommon.ImageSearchResultEntry","imgName":"1204325791.jpg","imgRelativePath": "0_All/41_xyz/0_All_Categories/53_34/1204325791.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/34/ce/1204325791.jpg", "info":null,"keyword":"white,animal, local","productPageUrl": "http://www.xyz.cn/r/photo/view/id/1204325791/","score":0.978022, "tagsList":null,"title":"Small fish in glass of water isolated"} ]}

API end point : http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem

Image format requirement: JPG format ,image width and length each for 300 – 1200 pix

Http method : POST

Request Parameters(body) :

Parameter Name	Type	Required	Parameter Location	Description	Default Value
apikey	string	Yes	header	API Key	None
imgname	string	Yes	header	Image name, must be unique. Example 123.jpg	None
catid	int	No	header	Category ID (1 – 3000 integer)	None
lang	String	No	header	Language: zh - Chinese;en - English	zh - Chinese
fmt	String	No	header	Response format: json or xml	json
kwds	String	No	header	input keywords, used for image + keywords hybrid search.	None
labels	String	No	header	Image labels, positive integer,separated by comma.Example: 65,58,408	None
title	String	No	header	Image title, example: dog on grass	None
info	String	No	header	You can put image related meta data here. Will be returned back in search result response.	None

Parameter Name	Type	Required	Parameter Location	Description	Default Value
photo	file	Yes	body	Image for uploading	None

														
Curl Example:
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem' -v  -F apikey=yourapikey  -F imgname=1.jpg   -F photo=@dog1.jpg    
														
Above curl request is do adding an image dog1.jpg , image name as 1.jpg ,  using your apikey,  values of other parameters as default.

import java.io.File;
import java.io.IOException;
import java.nio.charset.Charset;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiPnpSearch {

	public static final String DEF_CHATSET = "UTF-8";
    public static final int DEF_CONN_TIMEOUT = 3000;
    public static final int DEF_READ_TIMEOUT = 3000;
    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
    public static final String APPKEY ="*******************************_3";//APIKEY
    public static final String LANG ="zh";
    public static final String FMT ="json";
    
	public static String addItem(File file,String imgname,int catid,String kwds,String labels,String title,String info) throws IOException{
		CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse response = null;
        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
        String result =null;
        int scatid = 1;
        if(catid!=1){
        	scatid = catid;
        }
        try {
            HttpPost httppost = new HttpPost("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem");
            FileBody bin = new FileBody(file);
            StringBody keyBody = new StringBody(APPKEY , contentType);
            StringBody langBody = new StringBody(LANG , contentType);
            StringBody fmtBody = new StringBody(FMT , contentType);
            StringBody imgnameBody = new StringBody(imgname , contentType);
            StringBody catidBody = new StringBody(scatid+"" , contentType);
            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
            builder.addPart("apikey", keyBody)
            .addPart("photo", bin)
            .addPart("lang", langBody)
            .addPart("fmt", fmtBody)
            .addPart("imgname", imgnameBody)
            .addPart("catid", catidBody);
            if(kwds != null && kwds.isEmpty() == false){
           	 StringBody kwdsBody = new StringBody(kwds, Charset.forName("UTF-8"));
           	 builder .addPart("kwds", kwdsBody);
            }
            if(labels != null && labels.isEmpty() == false){
            	StringBody labelsBody = new StringBody(labels , contentType);
            	builder .addPart("labels", labelsBody);
            }
            if(title != null && title.isEmpty() == false){
            	StringBody titleBody = new StringBody(title , contentType);
            	builder .addPart("title", titleBody);
            }
            HttpEntity reqEntity =  builder.build();
            httppost.setEntity(reqEntity);
            response = httpClient.execute(httppost);
            HttpEntity resEntity = response.getEntity();
            if (resEntity != null) {
               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
                String charset = "UTF-8";   
  			  String content=EntityUtils.toString(response.getEntity(), charset);   
                System.out.println(content);
            }
            EntityUtils.consume(resEntity);
        }catch(Exception e){
            e.printStackTrace();
        }finally {
            response.close();
            httpClient.close();
        }
        return result;
	}
	
	public static void main(String[] args) {
		try {
			addItem(new File("/path/dog1.jpg"),"dog1.jpg",20,null,null,null,null);
			/*Above request is do adding an image with image dog1.jpg, image name as dog1.jpg ,  using your apikey,  values of other parameters as default. */	
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

# test_client.py
import urllib2_file
import urllib2

data = {
		'apikey': '**********************************_3',
        'photo':  open('/path/dog1.jpg'),
        'imgname':'dog1.jpg',
        'catid':'20',
        'kwds':'',
        'labels':'',
        'title':'',
        'info':''
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem', data)
content = f.read()
print(content)

#Above request is do adding an image with image dog1.jpg, image name as dog1.jpg ,  using your apikey,  values of other parameters as default.


require 'vendor/autoload.php';
use GuzzleHttp\Client;

$apikey = '*************';
$catid = '20';
$imgname = 'dog1.jpg';
$kwds = '';
$labels = '';
$filebody = fopen('/path/dog1.jpg', 'r');
$client = new GuzzleHttp\Client(['base_uri' => 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem']);
$response = $client->request('POST',  'apipnp_additem', [
    'multipart' => [
	        [
	            'name'     => 'apikey',
	            'contents' => $apikey,
	        ],
	        [
	            'name'     => 'catid',
	            'contents' => $catid,
	        ],
	        [
	            'name'     => 'photo',
	            'contents' => $filebody
	        ],
			[
	             'name'=> 'imgname ',
	            'contents' => $imgname 
		    ], 
			[
	             'name'=> 'kwds',
	            'contents' => $kwds 
	        ],
			[
	             'name'=> 'labels ',
	            'contents' => $labels
	        ],
			[
	             'name'=> 'title',
	            'contents' => $title 
	    	],
	    	[
	             'name'=> 'info',
	            'contents' => $info 
	    	]

		]
]);

$rbody = $response->getBody();
echo $rbody;

#Above request is do adding an image with image dog1.jpg, image name as dog1.jpg , using your apikey, values of other parameters as default.

Detailed use of tutorials

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
  
        public static string HttpUploadFile(string url, string file, string paramName, string contentType, NameValueCollection nvc)
        {
            string result = string.Empty;
            string boundary = "---------------------------" + DateTime.Now.Ticks.ToString("x");
            byte[] boundarybytes = System.Text.Encoding.ASCII.GetBytes("\r\n--" + boundary + "\r\n");

            HttpWebRequest wr = (HttpWebRequest)WebRequest.Create(url);
            wr.ContentType = "multipart/form-data; boundary=" + boundary;
            wr.Method = "POST";
            wr.KeepAlive = true;
            wr.Credentials = System.Net.CredentialCache.DefaultCredentials;

            Stream rs = wr.GetRequestStream();

            string formdataTemplate = "Content-Disposition: form-data; name=\"{0}\"\r\n\r\n{1}";
            foreach (string key in nvc.Keys)
            {
                rs.Write(boundarybytes, 0, boundarybytes.Length);
                string formitem = string.Format(formdataTemplate, key, nvc[key]);
                byte[] formitembytes = System.Text.Encoding.UTF8.GetBytes(formitem);
                rs.Write(formitembytes, 0, formitembytes.Length);
            }
            rs.Write(boundarybytes, 0, boundarybytes.Length);

            string headerTemplate = "Content-Disposition: form-data; name=\"{0}\"; filename=\"{1}\"\r\nContent-Type: {2}\r\n\r\n";
            string header = string.Format(headerTemplate, paramName, file, contentType);
            byte[] headerbytes = System.Text.Encoding.UTF8.GetBytes(header);
            rs.Write(headerbytes, 0, headerbytes.Length);

            FileStream fileStream = new FileStream(file, FileMode.Open, FileAccess.Read);
            byte[] buffer = new byte[4096];
            int bytesRead = 0;
            while ((bytesRead = fileStream.Read(buffer, 0, buffer.Length)) != 0)
            {
                rs.Write(buffer, 0, bytesRead);
            }
            fileStream.Close();

            byte[] trailer = System.Text.Encoding.ASCII.GetBytes("\r\n--" + boundary + "--\r\n");
            rs.Write(trailer, 0, trailer.Length);
            rs.Close();

            WebResponse wresp = null;
            try
            {
                wresp = wr.GetResponse();
                Stream stream2 = wresp.GetResponseStream();
                StreamReader reader2 = new StreamReader(stream2);

                result = reader2.ReadToEnd();
            }
            catch (Exception ex)
            {
                if (wresp != null)
                {
                    wresp.Close();
                    wresp = null;
                }
            }
            finally
            {
                wr = null;
            }

            return result;
        }
        static void Main(string[] args)
            {
            NameValueCollection nvc1 = new NameValueCollection();
            nvc1.Add("apikey", "**************");
            nvc1.Add("catid", "20");
            nvc1.Add("fmt", "json");
            nvc1.Add("imgname", "dog1.jpg");
            String s1 =  HttpUploadFile("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem", "/path/dog1.jpg", "photo", "image/jpeg", nvc1);
            Console.WriteLine(s1);
            Console.ReadKey();
            //Above request is do adding an image with image URL dog1.jpg, image name as dog1.jpg ,  using your apikey,  values of other parameters as default. 
         }
        }
}

Parameter Name	Type	Required	Parameter Location	Description	Default Value
apikey	string	Yes	header	API Key	None
imgname	string	Yes	header	Image name, must be unique. Example 123.jpg	None
imgurl	string	Yes	header	Image URL	None
catid	int	No	header	Category ID (1 – 3000 integer)	None
lang	String	No	header	Language: zh - Chinese;en - English	zh - Chinese
fmt	String	No	header	Response format: json or xml	json
kwds	String	No	header	input keywords, used for image + keywords hybrid search.	None
labels	String	No	header	Image labels, positive integer,separated by comma.Example: 65,58,408	None
title	String	No	header	Image title, example: dog on grass	None
info	String	No	header	You can put image related meta data here. Will be returned back in search result response.	None

													
Curl Example::
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem' -v  -F apikey=yourapikey  -F imgname=1.jpg  
													
Above curl request is do adding an image with image URL http://www.xyz.com/img/dog1.jpg, image name as 1.jpg ,  using your apikey,  values of other parameters as default.

import java.io.IOException;
import java.nio.charset.Charset;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiPnpSearch {
	
	public static final String DEF_CHATSET = "UTF-8";
    public static final int DEF_CONN_TIMEOUT = 3000;
    public static final int DEF_READ_TIMEOUT = 3000;
    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
    public static final String APPKEY ="*******************************_3";
    
	public static String addItemByImageURL(String imgname,String imgurl) throws IOException{
		CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse response = null;
        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
        String result =null;
        try {
            HttpPost httppost = new HttpPost("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem");
            StringBody keyBody = new StringBody(APPKEY , contentType);
            StringBody imgnameBody = new StringBody(imgname , contentType);
            StringBody imgurlBody = new StringBody(imgurl , contentType);
            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
            builder.addPart("apikey", keyBody)
            .addPart("imgname", imgnameBody)
            .addPart(" imgurl", imgurlBody);
            HttpEntity reqEntity =  builder.build();
            httppost.setEntity(reqEntity);
            response = httpClient.execute(httppost);
            HttpEntity resEntity = response.getEntity();
            if (resEntity != null) {
               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
                String charset = "UTF-8";   
  			  String content=EntityUtils.toString(response.getEntity(), charset);   
                System.out.println(content);
            }
            EntityUtils.consume(resEntity);
        }catch(Exception e){
            e.printStackTrace();
        }finally {
            response.close();
            httpClient.close();
        }
        return result;
	}
	
	public static void main(String[] args) {
		try {
			addItemByImageURL("dog1.jpg","http://www.xyz.com/img/dog1.jpg",);
			/*Above request is do adding an image with image URL http://www.xyz.com/img/dog1.jpg, image name as dog1.jpg ,  using your apikey,  values of other parameters as default.  */	
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

# test_client.py
import urllib2_file
import urllib2

data = {
		'apikey': '**********************************_3',
        "imgurl" : "http://www.xyz.com/img/dog1.jpg"",
        'imgname':'dog1.jpg',
        'catid':'0',
        'kwds':'',
        'labels':'',
        'title':'',
        'info':''
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem', data)
content = f.read()
print(content)

#Above request is do adding an image with image URL http://www.xyz.com/img/dog1.jpg, image name as dog1.jpg ,  using your apikey,  values of other parameters as default.


$query = array(
      "imgurl" => "http://www.xyz.com/img/dog1.jpg",
      "apikey" => "********************************_3",//APP Key
      "imgname" => "dog1.jpg"
  );
  $result = post2("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem",$query);
  echo($result);

 function post2($url, $data){//file_get_content
         
        $postdata = http_build_query(
            $data
        );
 
        $opts = array('http' =>
 
                      array(
                          'method'  => 'POST',
                          'header'  => 'Content-type: application/x-www-form-urlencoded',
                          'content' => $postdata,
                      )
 
        );
 
        $context = stream_context_create($opts);
        $result = file_get_contents($url, false, $context);
        return $result;
    }    

#Above request is do adding an image with image URL http://www.xyz.com/img/dog1.jpg, image name as dog1.jpg ,  using your apikey,  values of other parameters as default.

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
    public class HttpWebResponseUtility
    {
        private static readonly string DefaultUserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)";
        
        public static HttpWebResponse CreatePostHttpResponse(string url, IDictionary<string, string> parameters, int? timeout,string path, string userAgent, Encoding requestEncoding, CookieCollection cookies)
        {
            if (string.IsNullOrEmpty(url))
            {
                throw new ArgumentNullException("url");
            }
            if (requestEncoding == null)
            {
                throw new ArgumentNullException("requestEncoding");
            }
            HttpWebRequest request = null;
            
            if (url.StartsWith("https", StringComparison.OrdinalIgnoreCase))
            {
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
                request = WebRequest.Create(url) as HttpWebRequest;
                request.ProtocolVersion = HttpVersion.Version10;
            }
            else
            {
                request = WebRequest.Create(url) as HttpWebRequest;
            }
            request.Method = "POST";
            request.ContentType = "application/x-www-form-urlencoded";

            if (!string.IsNullOrEmpty(userAgent))
            {
                request.UserAgent = userAgent;
            }
            else
            {
                request.UserAgent = DefaultUserAgent;
            }

            if (timeout.HasValue)
            {
                request.Timeout = timeout.Value;
            }
            if (cookies != null)
            {
                request.CookieContainer = new CookieContainer();
                request.CookieContainer.Add(cookies);
            }

            Stream stream = request.GetRequestStream();
            if (path != null) 
            { 
                FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read);
                byte[] bArr = new byte[fs.Length];
                fs.Read(bArr, 0, bArr.Length);
                fs.Close();
               stream.Write(bArr, 0, bArr.Length);
            
            }
           
            if (!(parameters == null || parameters.Count == 0))
            {
                StringBuilder buffer = new StringBuilder();
                int i = 0;
                foreach (string key in parameters.Keys)
                {
                    if (i > 0)
                    {
                        buffer.AppendFormat("&{0}={1}", key, parameters[key]);
                    }
                    else
                    {
                        buffer.AppendFormat("{0}={1}", key, parameters[key]);
                    }
                    i++;
                }
                byte[] data = requestEncoding.GetBytes(buffer.ToString());
                stream.Write(data, 0, data.Length);
            
            }
            return request.GetResponse() as HttpWebResponse;
        }
       
        static void Main(string[] args)
        {
            string url = "http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_additem";
            IDictionary<string, string> parameters = new Dictionary<string, string>();
            parameters.Add("apikey", "**************");
            parameters.Add("catid", "0");
            parameters.Add("fmt", "json");
            parameters.Add("imgurl", "http://www.xyz.com/img/dog1.jpg");
            parameters.Add("imgname", "dog1.jpg");
            HttpWebResponse response = HttpWebResponseUtility.CreatePostHttpResponse(url, parameters, null, null, null, Encoding.UTF8, null);
            StringBuilder content = new StringBuilder();
            Stream responseStream = response.GetResponseStream();
            StreamReader sReader = new StreamReader(responseStream, Encoding.GetEncoding("utf-8"));
            Char[] sReaderBuffer = new Char[256];
            int count = sReader.Read(sReaderBuffer, 0, 256);
            while (count > 0)
            {
                String tempStr = new String(sReaderBuffer, 0, count);
                content.Append(tempStr);
                count = sReader.Read(sReaderBuffer, 0, 256);
            }
            sReader.Close();
            Console.WriteLine(content.ToString());
            Console.ReadKey(); 
            //#Above request is do adding an image with image URL http://www.xyz.com/img/dog1.jpg, image name as dog1.jpg ,  using your apikey,  values of other parameters as default. 
         }
        }
}

API end point : http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_deleteitem

Http method: POST

Request Parameters(body) :

Parameter Name	Type	Required	Parameter Location	Description	Default Value
apikey	string	Yes	header	API Key	None
imgname	string	Yes	header	Image name, must be unique.Example 123.jpg	None
fmt	string	Yes	header	Response format: json or xml	json

													
Curl Example:
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_deleteitem' -v -F apikey=yourapikey  -F imgname=1.jpg
													
Above request is to delete an image 1.jpg, using your apikey, values of other parameters as default.

import java.io.IOException;
import java.nio.charset.Charset;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiPnpSearch {

	
	public static final String DEF_CHATSET = "UTF-8";
    public static final int DEF_CONN_TIMEOUT = 3000;
    public static final int DEF_READ_TIMEOUT = 3000;
    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
    public static final String APPKEY ="*******************************_3";
    
	public static String deleteItem(String imgname) throws IOException{
		CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse response = null;
        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
        String result =null;
        try {
            HttpPost httppost = new HttpPost(" http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_deleteitem");
            StringBody keyBody = new StringBody(APPKEY , contentType);
            StringBody fmtBody = new StringBody(FMT , contentType);
            StringBody imgnameBody = new StringBody(imgname , contentType);
            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
            builder.addPart("apikey", keyBody)
            .addPart("fmt", fmtBody)
            .addPart("imgname", imgnameBody);
            HttpEntity reqEntity =  builder.build();
            httppost.setEntity(reqEntity);
            response = httpClient.execute(httppost);
            HttpEntity resEntity = response.getEntity();
            if (resEntity != null) {
               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
                String charset = "UTF-8";   
  			  String content=EntityUtils.toString(response.getEntity(), charset);   
                System.out.println(content);
            }
            EntityUtils.consume(resEntity);
        }catch(Exception e){
            e.printStackTrace();
        }finally {
            response.close();
            httpClient.close();
        }
        return result;
	}
	
	public static void main(String[] args) {
		try {
			deleteItem("dog1.jpg");
			/*Above request is to delete an image dog1.jpg, using your apikey, values of other parameters as default */	
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

# test_client.py
import urllib2_file
import urllib2

data = {
		'apikey': '**********************************_3',
        'imgname':'dog1.jpg'
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_deleteitem', data)
content = f.read()
print(content)

#Above request is to delete an image dog1.jpg, using your apikey, values of other parameters as default


$query = array(
     "apikey" => "**********************************_3",
      "imgname""=>'dog1.jpg"
  );
  $result = post2("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apisim_deleteitem",$query);
  echo($result);

 function post2($url, $data){//file_get_content
         
        $postdata = http_build_query(
            $data
        );
 
        $opts = array('http' =>
 
                      array(
                          'method'  => 'POST',
                          'header'  => 'Content-type: application/x-www-form-urlencoded',
                          'content' => $postdata,
                      )
 
        );
 
        $context = stream_context_create($opts);
        $result = file_get_contents($url, false, $context);
        return $result;
    }
#Above request is to delete an image dog1.jpg, using your apikey, values of other parameters as default

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
    public class HttpWebResponseUtility
    {
        private static readonly string DefaultUserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)";
        
         public static HttpWebResponse CreatePostHttpResponse(string url, IDictionary<string, string> parameters, int? timeout,string path, string userAgent, Encoding requestEncoding, CookieCollection cookies)
        {
            if (string.IsNullOrEmpty(url))
            {
                throw new ArgumentNullException("url");
            }
            if (requestEncoding == null)
            {
                throw new ArgumentNullException("requestEncoding");
            }
            HttpWebRequest request = null;
           
            if (url.StartsWith("https", StringComparison.OrdinalIgnoreCase))
            {
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
                request = WebRequest.Create(url) as HttpWebRequest;
                request.ProtocolVersion = HttpVersion.Version10;
            }
            else
            {
                request = WebRequest.Create(url) as HttpWebRequest;
            }
            request.Method = "POST";
            request.ContentType = "application/x-www-form-urlencoded";

            if (!string.IsNullOrEmpty(userAgent))
            {
                request.UserAgent = userAgent;
            }
            else
            {
                request.UserAgent = DefaultUserAgent;
            }

            if (timeout.HasValue)
            {
                request.Timeout = timeout.Value;
            }
            if (cookies != null)
            {
                request.CookieContainer = new CookieContainer();
                request.CookieContainer.Add(cookies);
            }

            Stream stream = request.GetRequestStream();
            if (path != null) 
            { 
                FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read);
                byte[] bArr = new byte[fs.Length];
                fs.Read(bArr, 0, bArr.Length);
                fs.Close();
               stream.Write(bArr, 0, bArr.Length);
            
            }
          
            if (!(parameters == null || parameters.Count == 0))
            {
                StringBuilder buffer = new StringBuilder();
                int i = 0;
                foreach (string key in parameters.Keys)
                {
                    if (i > 0)
                    {
                        buffer.AppendFormat("&{0}={1}", key, parameters[key]);
                    }
                    else
                    {
                        buffer.AppendFormat("{0}={1}", key, parameters[key]);
                    }
                    i++;
                }
                byte[] data = requestEncoding.GetBytes(buffer.ToString());
                stream.Write(data, 0, data.Length);
            
            }
            return request.GetResponse() as HttpWebResponse;
        }
       
        static void Main(string[] args)
        {
            string url = " http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apisim_deleteitem";
            IDictionary<string, string> parameters = new Dictionary<string, string>();
            parameters.Add("apikey", "**************");
            parameters.Add("catid", "0");
            parameters.Add("fmt", "json");
            parameters.Add("imgname", "1.jpg");
            HttpWebResponse response = HttpWebResponseUtility.CreatePostHttpResponse(url, parameters, null, null, null, Encoding.UTF8, null);
            StringBuilder content = new StringBuilder();
            Stream responseStream = response.GetResponseStream();
            StreamReader sReader = new StreamReader(responseStream, Encoding.GetEncoding("utf-8"));
            Char[] sReaderBuffer = new Char[256];
            int count = sReader.Read(sReaderBuffer, 0, 256);
            while (count > 0)
            {
                String tempStr = new String(sReaderBuffer, 0, count);
                content.Append(tempStr);
                count = sReader.Read(sReaderBuffer, 0, 256);
            }
            sReader.Close();
            Console.WriteLine(content.ToString());
            Console.ReadKey(); 
            //#Above request is to delete an image dog1.jpg, using your apikey, values of other parameters as default     
         }
        }
}

API end point : http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_detail

Http method : POST or GET

Request Parameters(body/header) :

Parameter Name	Type	Required	Parameter Location	Description	Default Value
apikey	string	Yes	header	API Key	None
imgname	string	Yes	header	Image name, must be unique.Example 123.jpg	None
fmt	string	Yes	header	Response format: json or xml	json

														
Curl Example:
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_detail' -v -F apikey=yourapikey -F imgname=1.jpg
													
Above request is to look up image by image name 1.jpg , using your apikey, values of other parameters as default

import java.io.IOException;
import java.nio.charset.Charset;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiPnpSearch {
	
	public static final String DEF_CHATSET = "UTF-8";
    public static final int DEF_CONN_TIMEOUT = 3000;
    public static final int DEF_READ_TIMEOUT = 3000;
    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
    public static final String APPKEY ="*******************************_3";
    
	public static String detailItem(String imgname) throws IOException{
		CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse response = null;
        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
        String result =null;
        try {
            HttpPost httppost = new HttpPost("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_detail");
            StringBody keyBody = new StringBody(APPKEY , contentType);
            StringBody fmtBody = new StringBody(FMT , contentType);
            StringBody imgnameBody = new StringBody(imgname , contentType);
            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
            builder.addPart("apikey", keyBody)
            .addPart("fmt", fmtBody)
            .addPart("imgname", imgnameBody);
            HttpEntity reqEntity =  builder.build();
            httppost.setEntity(reqEntity);
            response = httpClient.execute(httppost);
            HttpEntity resEntity = response.getEntity();
            if (resEntity != null) {
               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
                String charset = "UTF-8";   
  			  String content=EntityUtils.toString(response.getEntity(), charset);   
                System.out.println(content);
            }
            EntityUtils.consume(resEntity);
        }catch(Exception e){
            e.printStackTrace();
        }finally {
            response.close();
            httpClient.close();
        }
        return result;
	}
	
	public static void main(String[] args) {
		try {
			detailItem("dog1.jpg");
			/*Above request is to look up image by image name dog1.jpg , using your apikey, values of other parameters as default*/	
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

# test_client.py
import urllib2_file
import urllib2

data = {
		'apikey': '**********************************_3',
        'imgname':'dog1.jpg'
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_detail  ', data)
content = f.read()
print(content)

#Above request is to look up image by image name dog1.jpg , using your apikey, values of other parameters as default

$query = array(
      "apikey" => "**********************************_3",
      "imgname""=>'dog1.jpg"
  );
  $result = post2("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apisim_detail",$query);
  echo($result);

 function post2($url, $data){//file_get_content
         
        $postdata = http_build_query(
            $data
        );
 
        $opts = array('http' =>
 
                      array(
                          'method'  => 'POST',
                          'header'  => 'Content-type: application/x-www-form-urlencoded',
                          'content' => $postdata,
                      )
 
        );
 
        $context = stream_context_create($opts);
        $result = file_get_contents($url, false, $context);
        return $result;
    }
#Above request is to look up image by image name dog1.jpg , using your apikey, values of other parameters as default

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
    public class HttpWebResponseUtility
    {
        private static readonly string DefaultUserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)";
        
       public static HttpWebResponse CreatePostHttpResponse(string url, IDictionary<string, string> parameters, int? timeout,string path, string userAgent, Encoding requestEncoding, CookieCollection cookies)
        {
            if (string.IsNullOrEmpty(url))
            {
                throw new ArgumentNullException("url");
            }
            if (requestEncoding == null)
            {
                throw new ArgumentNullException("requestEncoding");
            }
            HttpWebRequest request = null;
           
            if (url.StartsWith("https", StringComparison.OrdinalIgnoreCase))
            {
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
                request = WebRequest.Create(url) as HttpWebRequest;
                request.ProtocolVersion = HttpVersion.Version10;
            }
            else
            {
                request = WebRequest.Create(url) as HttpWebRequest;
            }
            request.Method = "POST";
            request.ContentType = "application/x-www-form-urlencoded";

            if (!string.IsNullOrEmpty(userAgent))
            {
                request.UserAgent = userAgent;
            }
            else
            {
                request.UserAgent = DefaultUserAgent;
            }

            if (timeout.HasValue)
            {
                request.Timeout = timeout.Value;
            }
            if (cookies != null)
            {
                request.CookieContainer = new CookieContainer();
                request.CookieContainer.Add(cookies);
            }

            Stream stream = request.GetRequestStream();
            if (path != null) 
            { 
                FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read);
                byte[] bArr = new byte[fs.Length];
                fs.Read(bArr, 0, bArr.Length);
                fs.Close();
               stream.Write(bArr, 0, bArr.Length);
            
            }
           
            if (!(parameters == null || parameters.Count == 0))
            {
                StringBuilder buffer = new StringBuilder();
                int i = 0;
                foreach (string key in parameters.Keys)
                {
                    if (i > 0)
                    {
                        buffer.AppendFormat("&{0}={1}", key, parameters[key]);
                    }
                    else
                    {
                        buffer.AppendFormat("{0}={1}", key, parameters[key]);
                    }
                    i++;
                }
                byte[] data = requestEncoding.GetBytes(buffer.ToString());
                stream.Write(data, 0, data.Length);
            
            }
            return request.GetResponse() as HttpWebResponse;
        }
       
        static void Main(string[] args)
        {
            string url = "http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apisim_detail";
            IDictionary<string, string> parameters = new Dictionary<string, string>();
            parameters.Add("apikey", "**************");
            parameters.Add("catid", "0");
            parameters.Add("fmt", "json");
            parameters.Add("imgname", "1.jpg");
            HttpWebResponse response = HttpWebResponseUtility.CreatePostHttpResponse(url, parameters, null, null, null, Encoding.UTF8, null);
            StringBuilder content = new StringBuilder();
            Stream responseStream = response.GetResponseStream();
            StreamReader sReader = new StreamReader(responseStream, Encoding.GetEncoding("utf-8"));
            Char[] sReaderBuffer = new Char[256];
            int count = sReader.Read(sReaderBuffer, 0, 256);
            while (count > 0)
            {
                String tempStr = new String(sReaderBuffer, 0, count);
                content.Append(tempStr);
                count = sReader.Read(sReaderBuffer, 0, 256);
            }
            sReader.Close();
            Console.WriteLine(content.ToString());
            Console.ReadKey(); 
            //Above request is to look up image by image name dog1.jpg , using your apikey, values of other parameters as default    
         }
        }
}

API end point :http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse

Image format requirement: JPG format, image width and length each for 300 – 800 pix

Http method : POST or GET

Request Parameters(body/header) :

Parameter Name	Type	Required	Parameter Location	Description	Default Value
apikey	string	Yes	header	API Key	None
catid	No	No	header	Category ID (1 – 3000 integer)	0 (means all categories)
lang	string	No	header	Language: zh - Chinese; en - English	zh - Chinese
fmt	string	No	header	Response format: json or xml	json
subject	int	No	header	input keywords, used for image + keywords hybrid search	None
labeland	string	No	header	AND logic labels for input image, positive integer,Example:65,58,408	None
labelor	string	No	header	OR logic labels for input image,positive integer,Example:305,38,5	None
labelnot	string	No	header	NOT logic labels for input image,positive integer,Example:345,368,45	None
p	string	否	body/header	流览显示第p页面, p 为大于或等于1正整数	1
numperpage	string	否	body/header	每页流览显示多少个, 应为正整数	16
maxitems	string	否	body/header	最多一共流览显示多少个, 应为正整数	200

														
Curl Example1:
														
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse' -v  -F apikey=your apikey
														
Above request is browse image,using your apikey, values of other parameters as default    
														
http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse?apikey=your apikey
														
curlExample2:
														
curl 'http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse' -v  -F apikey=your apikey -F subject=pet -F catid=45 -F labeland=345,356 -F labelnot=98

import java.io.File;
import java.io.IOException;
import java.nio.charset.Charset;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiPnpSearch {
	public static final String DEF_CHATSET = "UTF-8";
    public static final int DEF_CONN_TIMEOUT = 3000;
    public static final int DEF_READ_TIMEOUT = 3000;
    public static String userAgent =  "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
    public static final String APPKEY ="*******************************_3";
    public static final String LANG ="zh";
    public static final String FMT ="json";
    
	public static String apiBrowse(int  catid ,String subject,String labeland,String labelor,String labelnot,String p,String numperpage,
	String maxitems) throws IOException{
			CloseableHttpClient httpClient = HttpClients.createDefault();
	        CloseableHttpResponse response = null;
	        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
	        String result =null;
	        try {
	            HttpPost httppost = new HttpPost("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse");
	            
	            FileBody bin = new FileBody(file);
	            StringBody catidBody = new StringBody(catid+"" , contentType);
	            StringBody keyBody = new StringBody(APPKEY , contentType);
	            StringBody langBody = new StringBody(LANG , contentType);
	            StringBody fmtBody = new StringBody(FMT , contentType);
	            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
	            builder.addPart("apikey", keyBody)
	            .addPart("catid", catidBody)
	            .addPart("lang", langBody)
	            .addPart("fmt", fmtBody);
	             if(subject != null && subject.isEmpty() == false){
	            	 StringBody subjectBody = new StringBody(subject, Charset.forName("UTF-8"));
	            	 builder.addPart("subject", subjectBody);
	             } 
	             if(labeland != null && labeland.isEmpty() == false){
	            	 StringBody labelandBody = new StringBody(labeland , contentType);
	            	 builder .addPart("labeland", labelandBody);
	             }
	             if(labelor != null && labelor.isEmpty() == false){
	            	 StringBody labelorBody = new StringBody(labelor , contentType);
	            	 builder .addPart("labelor", labelorBody);
	             }
	             if(labelnot != null && labelnot.isEmpty() == false){
	            	 StringBody labelnotBody = new StringBody(labelnot , contentType);
	            	 builder .addPart("labelnot", labelnotBody);
	             }
	             if(p != null && p.isEmpty() == false){
	            	 StringBody pBody = new StringBody(p , contentType);
	            	 builder .addPart("p", pBody);
	             }
	             if(numperpage != null && numperpage.isEmpty() == false){
	            	 StringBody numperpageBody = new StringBody(numperpage , contentType);
	            	 builder .addPart(numperpage",numperpageBody);
	             }
	             if(maxitems != null && maxitems.isEmpty() == false){
	            	 StringBody maxitemsBody = new StringBody(maxitems , contentType);
	            	 builder .addPart("maxitems", maxitemspBody);
	             }
	            HttpEntity reqEntity =  builder.build();
	            httppost.setEntity(reqEntity);
	            response = httpClient.execute(httppost);
	            HttpEntity resEntity = response.getEntity();
	            if (resEntity != null) {
	               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
	                String charset = "UTF-8";   
	  			  String content=EntityUtils.toString(response.getEntity(), charset);   
	                System.out.println(content);
	            }
	            EntityUtils.consume(resEntity);
	        }catch(Exception e){
	            e.printStackTrace();
	        }finally {
	            response.close();
	            httpClient.close();
	        }
	        return result;
		}
	
	public static void main(String[] args) {
		try {
			apiBrowse(0,null,null,null,null,null,null,null);
			/*Above request is browse image,using your apikey, values of other parameters as default    */	
			apiBrowse(45,"pet","345,356",null,"98",null,null,null);
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
	
}

# test_client.py
import urllib2_file
import urllib2

data = {
		'apikey': '**********************************_3',
        'catid':'0',
        'subject':'',
        'labeland':'',
        'labelor':'',
        'labelnot':'',
        'p':'1',
        'numperpage':'16',
        'maxitems':'200'
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse', data)
content = f.read()	
print(content)

#Above request is browse image,using your apikey, values of other parameters as default    											 	
data = {
		'apikey': '**********************************_3',#你的apikey
        'catid':'45',
        'subject':'pet',
        'labeland':'345,356',
        'labelor':'',
        'labelnot':'98',
         'p':'1',
        'numperpage':'16',
        'maxitems':'200'
       }
f = urllib2.urlopen('http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse', data)
content = f.read()
print(content)

$query = array(
      	'apikey' =>'************',
        'catid' => '0',
        'subject'=> '',
        'labeland'=> '',
        'labelor'=> '',
        'labelnot'=> '',
         'p'=>'1',
        'numperpage'=>'16',
        'maxitems'=>'200'
  );
  $result = post2("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse",$query);
  echo($result);

 function post2($url, $data){//file_get_content
         
        $postdata = http_build_query(
            $data
        );
 
        $opts = array('http' =>
 
                      array(
                          'method'  => 'POST',
                          'header'  => 'Content-type: application/x-www-form-urlencoded',
                          'content' => $postdata,
                      )
 
        );
 
        $context = stream_context_create($opts);
        $result = file_get_contents($url, false, $context);
        return $result;
    } 

#Above request is browse image,using your apikey, values of other parameters as default    

  $query = array(
        'apikey' => '************', 
        'catid' => '45',
        'subject'=> 'pet',
        'labeland'=> '345,356',
        'labelor'=> '',
        'labelnot'=> '98',
        'p'=>'1',
        'numperpage'=>'16',
        'maxitems'=>'200'
  );
  $result = post2("http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse",$query);
  echo($result);

 function post2($url, $data){//file_get_content
         
        $postdata = http_build_query(
            $data
        );
 
        $opts = array('http' =>
 
                      array(
                          'method'  => 'POST',
                          'header'  => 'Content-type: application/x-www-form-urlencoded',
                          'content' => $postdata,
                      )
 
        );
 
        $context = stream_context_create($opts);
        $result = file_get_contents($url, false, $context);
        return $result;
    }

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
    public class HttpWebResponseUtility
    {
        private static readonly string DefaultUserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)";
        
         public static HttpWebResponse CreatePostHttpResponse(string url, IDictionary<string, string> parameters, int? timeout,string path, string userAgent, Encoding requestEncoding, CookieCollection cookies)
        {
            if (string.IsNullOrEmpty(url))
            {
                throw new ArgumentNullException("url");
            }
            if (requestEncoding == null)
            {
                throw new ArgumentNullException("requestEncoding");
            }
            HttpWebRequest request = null;
            
            if (url.StartsWith("https", StringComparison.OrdinalIgnoreCase))
            {
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
                request = WebRequest.Create(url) as HttpWebRequest;
                request.ProtocolVersion = HttpVersion.Version10;
            }
            else
            {
                request = WebRequest.Create(url) as HttpWebRequest;
            }
            request.Method = "POST";
            request.ContentType = "application/x-www-form-urlencoded";

            if (!string.IsNullOrEmpty(userAgent))
            {
                request.UserAgent = userAgent;
            }
            else
            {
                request.UserAgent = DefaultUserAgent;
            }

            if (timeout.HasValue)
            {
                request.Timeout = timeout.Value;
            }
            if (cookies != null)
            {
                request.CookieContainer = new CookieContainer();
                request.CookieContainer.Add(cookies);
            }

            Stream stream = request.GetRequestStream();
            if (path != null) 
            { 
                FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read);
                byte[] bArr = new byte[fs.Length];
                fs.Read(bArr, 0, bArr.Length);
                fs.Close();
               stream.Write(bArr, 0, bArr.Length);
            
            }
            
            if (!(parameters == null || parameters.Count == 0))
            {
                StringBuilder buffer = new StringBuilder();
                int i = 0;
                foreach (string key in parameters.Keys)
                {
                    if (i > 0)
                    {
                        buffer.AppendFormat("&{0}={1}", key, parameters[key]);
                    }
                    else
                    {
                        buffer.AppendFormat("{0}={1}", key, parameters[key]);
                    }
                    i++;
                }
                byte[] data = requestEncoding.GetBytes(buffer.ToString());
                stream.Write(data, 0, data.Length);
            
            }
            return request.GetResponse() as HttpWebResponse;
        }
       
        static void Main(string[] args)
        {
            string url = "http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse";
            IDictionary<string, string> parameters = new Dictionary<string, string>();
            parameters.Add("apikey", "**************");
            parameters.Add("catid", "0");
            parameters.Add("fmt", "json");
            parameters.Add("p", "1");
            parameters.Add("numperpage", "16");
            parameters.Add("maxitems", "200");
            HttpWebResponse response = HttpWebResponseUtility.CreatePostHttpResponse(url, parameters, null, null, null, Encoding.UTF8, null);
            StringBuilder content = new StringBuilder();
            Stream responseStream = response.GetResponseStream();
            StreamReader sReader = new StreamReader(responseStream, Encoding.GetEncoding("utf-8"));
            Char[] sReaderBuffer = new Char[256];
            int count = sReader.Read(sReaderBuffer, 0, 256);
            while (count > 0)
            {
                String tempStr = new String(sReaderBuffer, 0, count);
                content.Append(tempStr);
                count = sReader.Read(sReaderBuffer, 0, 256);
            }
            sReader.Close();
            Console.WriteLine(content.ToString());
            Console.ReadKey(); 
          	//Above request is browse image,using your apikey, values of other parameters as default    

             string url1 = "http://www.visualsearchapi.com:8084/vsearchtech/api/v1.0/apipnp_browse";
            IDictionary<string, string> parameters1 = new Dictionary<string, string>();
            parameters1.Add("apikey", "**************");
            parameters1.Add("catid", "0");
            parameters1.Add("fmt", "json");
            parameters1.Add("subject", "pet");
            parameters1.Add("labeland", "345,356");
            parameters1.Add("labeland", "98");
            parameters1.Add("p", "1");
            parameters1.Add("numperpage", "16");
            parameters1.Add("maxitems", "200");
            HttpWebResponse response = HttpWebResponseUtility.CreatePostHttpResponse(url1, parameters1, null, null, null, Encoding.UTF8, null);
            StringBuilder content = new StringBuilder();
            Stream responseStream = response.GetResponseStream();
            StreamReader sReader = new StreamReader(responseStream, Encoding.GetEncoding("utf-8"));
            Char[] sReaderBuffer = new Char[256];
            int count = sReader.Read(sReaderBuffer, 0, 256);
            while (count > 0)
            {
                String tempStr = new String(sReaderBuffer, 0, count);
                content.Append(tempStr);
                count = sReader.Read(sReaderBuffer, 0, 256);
            }
            sReader.Close();
            Console.WriteLine(content.ToString());
            Console.ReadKey(); 
         }
        }
}

JSON Response Example :

{ resultList":[{"class":"vs.vscommon.ImageSearchResultEntry","imgName":"1392125321.jpg", "imgRelativePath":"0_All/41_xyz/0_All_Categories/227_e2/1392125321.jpg","imgUrl": "http://www.xyz.cn/images/front/v/pic2/e2/04/1392125321.jpg","info":null,"keyword": "Study,Signature","productPageUrl":"http://www.xyz.cn/r/photo/view/id/1392125321/", "score":0.9785203,"tagsList":null,"title":"Gold pen signing contract"},{"class": "vs.vscommon.ImageSearchResultEntry","imgName":"1204325791.jpg","imgRelativePath": "0_All/41_xyz/0_All_Categories/53_34/1204325791.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/34/ce/1204325791.jpg", "info":null,"keyword":"white,animal, local","productPageUrl": "http://www.xyz.cn/r/photo/view/id/1204325791/","score":0.978022, "tagsList":null,"title":"Small fish in glass of water isolated"} ]}

Download Java resources
Download Python resources
Download Php resources

Error Code Reference:

Error Codes Related to Access Control:

API_CODE_ERROR_exceeded_access_total	Exceeded API access limit in total
API_CODE_ERROR_exceeded_access_frequency	Exceeded API access frequency limit
API_CODE_ERROR_exceeded_access_frequency_min	Exceeded API access limit per minute
API_CODE_ERROR_exceeded_access_frequency_hr	Exceeded API access limit per hour
API_CODE_ERROR_exceeded_access_frequency_day	Exceeded API access limit per day
API_CODE_ERROR_exceeded_access_frequency_month	xceeded API access limit per month
API_CODE_ERROR_two_API_calls_time_too_close	Two API calls are too close in time
IMAGE_INDEX_CODE_ERROR_IMAGE_EXCEED_MAX_DOCS_PER_UID	Exceeded max number of images in index per user
API_CODE_ERROR_not_allow_write_index	Pause in adding image to index (server might be in maintain service, please wait )

Error Codes Related to Wrong Parameters：

API_CODE_ERROR_invalid_apikey	Invalid apikey
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgName	Invalid image name
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgUrl	Invalid image URL
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_catid_must_be_1_to_3000	Invalid image category (Must be 1-3000 Integer)
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_labels_must_be_positive_integer	Invalid label(Must be positive integer)
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_FIELDS_any_field_must_not_have_double_quote	Invalid image data, must not have double quote
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_LANG	Invalid language parameter(must be zh for Chinese or en for English)
IMAGE_INDEX_CODE_ERROR_DOWNLOAD_IMAGE	Error in downloading image, please check provided image URL
IMAGE_INDEX_CODE_ERROR_IMAGE_SIZE_TOO_BIG	Image size is too big(image must be 400 – 800PIX JPG format)
IMAGE_INDEX_DELETE_IMG_CODE_ERROR_NOT_FOUND_ITEM	Error in deleting, image not found

Great ability to resist input image noise, great for mobile Apps	Capable to resist noise of input image such as scaling, lighting change, rotating, and interference of background
Picture-in-picture partial matching	Capable to find a partial match even if the content of an input image is only part of an image in the image set
Dynamically adding & deleting items	You can add, modify, and delete your image and related meta data dynamically. Searchable immediately after successful adding
Meta data	You can add additional meta data such as product title, description, customized categories, any labels, all those are searchable by API
Image + keywords hybrid search	Allow to combine visual search and keywords search, known as hybrid search to more accurately search what users want
Filtering result by customized category	Allow to do visual search using filtering customized categories
Filtering result by customized labels	Allow to do visual search using filtering by customized labels

Image Recognition/Matching API Documentation

Image Recognition/Matching Features:

JSON Response Example:

JSON Response Example :

JSON Response Example :

Error Code Reference:

Error Codes Related to Access Control:

Error Codes Related to Wrong Parameters：