API - Application Programming Interface

The seo-proxies.com API documentation, free tools and source code

API documentation
Free tools and source code
The API documentation

	Our API can be used to integrate automated proxy handling into tools, macros and scripts.
	You could even create a bookmark in your browser to change your external IP on the fly!
	Disclaimer: you may not use our API for illegal activities and you may only use our API if you own an active license
	Hint: When configuring a tool, browser or script make sure you add our domain (seo-proxies.com) as proxy exception
	
	Our API is designed to integrate our IP services (IP rotation) into custom tools and scripts without much effort, however it can still be quite a task
	to develop your data analysis or mining tools. 
	If you require help from experienced people please contact our customer support, we can recommend experienced developers.
	
	Through the API you can do these actions
	* take IPs from the IP pool
	* start a proxy
	* stop a proxy
	* rotate your proxy to a random IP (IPs that were not used for a longer time are favored against IPs you used more recently)
	* rotate your proxy to a specific IP
	* verify your external IP
	
	General
	The API
	The API is a HTTP protocol, that means you can access it through a browser, a TCP session, CURL or similar.
	All API calls require: your userid,your encrypted password, a command name and optional parameters
	Your API password: d24479f7966bddb4e57451b8e35bb16d
	Your API userid  : -1
	Your first Proxy-Port : 7999
	
	The proxies
	The protocol of your proxy is the HTT, the SOCKS or the VPN protocol. You can switch the protocol in your profile at any time.
	All proxies run on the host "proxy.seo-proxies.com" , your first proxy port is 7999 .
	When using US portal the host will be "us-proxy.seo-proxies.com".
	This makes configuration a lot easier than usual:
	You simply configure proxy.seo-proxies.com:7999 as HTTP/SOCKS proxy!
	The external IP of the proxy is auto-tunneled by our server as you define it (rotate to a random IP or rotate to a specified IP)
	Each started proxy has a default lifetime of 7 hours (can be changed in your profile), after that you will have to start it again.
	VPN requires the installation of our VPN-package (see profile page) and will not expire/shut down while in use.
	
	Proxy authentication
	Our proxies are authenticated by your IP address. This happens when you rotate or start the proxy.

	This means that you do not have to configure any passwords or logins, all you need is to start the proxy and it will work.
	The VPN is authenticated by a secret key which is part of your VPN download package, the key can only be used from one computer at the same time.
	
	Using the API
	The API listens for HTTP GET requests, the below examples already include your current encrypted password and your userid.
	The base of all API calls: http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=
	
	The API is able to temporarily throttle API requests in case of an overload, depending on your license you can make more or less requests per hour.
	If you receive a throttle message make sure not to ignore it, please either contact us or work on your code to reduce the number of API requests.

	API TOS
	The API will issue automated temporal bans when detecting TOS violations.
	If you find yourself being blocked please make sure your tools do not violate our TOS.
	Especially DoS like behaviour or overusage, for example by causing Captcha responses from scraping search engines).
	Please always keep a reasonable delay between API calls as well as reasonable delays and quotas when accessing other webservices.
	For example, if you receive a Captcha page from Google you need to slow down as well as pause the affected IP address for at least an hour.
	
	

  API commands
	
	"hello" (http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=hello)
	The API call 'hello' can be used to test if the license is valid without changing anything.
	The parameter "&extended=1" can be used to append the configured proxy protocol and the max proxy processes number.
	A successful response is "HELLO:xx:yy" where xx is the total number of IPs in the license and yy the currently assigned IP count
        For extended requests the response looks like this:  "HELLO:IPs in license:IPs assigned:proxy protocol:proxy process limit"
	If the license is not ready it will return "ERROR:$code:$reason" or "HELLO:0:0"
	
	
	 "rotate" (http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=rotate)
	  When using the API call 'rotate' then the first started proxy is stopped and replaced by another proxy.
	  In case you had no proxy running a proxy is started for you.
	  In most cases all you need for your API integration is the rotate command!
	  Optional parameters: 
	    &ip_wish=xxx.xxx.xxx.xxx  , this requests the specific IP to be used for rotation
	    &authip=xxx.xxx.xxxx.xx   , this requests a different authorization IP than your own one
	    &randomness=0             , by default the rotation sort-order is based on the last-usage time. The last-usage time has a 5 hours
	                                fuzziness applied, so rotation sequences are mixed up a bit. randomness=0 removes the 5h fuzziness.
	    &offset=X                 , if your license allows multiple proxies you can use this parameter to control a specific proxy.
	                                0 is default (the first proxy)
	  Return values:
	  	ERROR:102:STOP FAILED:$IP_ADDRESS          : this might happen when the server experiences high load and can not stop your proxy
	  	ERROR:104:PROXY START FAILED:$IP_ADDRESS   : this might happen when the server experiences high load and can not start your proxy
	  	ERROR:103:NO NEW IP FOUND                   : this return value is currently not available and will be ready in future
	  	ROTATE:$PROXY_IP:$PORT:$IP_ADDRESS        : rotation successful. IP authentication for $AUTH_IP. 
	                                                  Proxy runs on proxy.seo-proxies.com:$port and has the external IP $IP_ADDRESS
	  	
	  "start" (http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=start&name=)
	   This command is used to start a specific IP, the use of "rotate" is recommended!.
	   The ip to start has to be supplied as parameter &name=xx.xx.xx.xx
	   Return values:
	     ERROR:301:Starting unknown/foreign proxy not allowed : the specified IP is not within your allocated IPs or unknown
	     ERROR:303:Proxy is already started or starting       : the specified IP is already booting up (usually a matter of 2-5 seconds)
	     ERROR:106:PROXY START FAILED:$IP_ADDRESS             : indication of high load on the server, try again in 10 seconds.
	     START:$PROXY_IP:$PORT:$IP_ADDRESS                                 : start of IP succeeded, the proxy runs through proxy.seo-proxies.com:$PORT
	     
	
	   "stop" (http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=stop&name=)
	    This command is used to stop a running proxy once you are finished, this is only required when managing IPs without the use of the "rotate" cmd
	    The parameter &name=xx.xx.xx.xx is required, to tell the API which Proxy to stop.
	    Return values:
	      ERROR:501:Proxy not found running:$IP_ADDRESS       : the specified proxy is not started
	      ERROR:102:STOP FAILED:$IP_ADDRESS                   : indication of high load on the server
	      STOP:FINISHED:$IP_ADDRESS                           : stop finished successfully

	   "comment" (http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=comment&ip=&text=)
	    This command can be used to add, change, remove and view comments of a selected IP
	    The parameter &ip=xx.xx.xx.xx is required, to tell the API which Proxy to check.
	    The parameter &text=html_encoded_text, is used to change or remove the comment
	    The parameter &view is used to view the selected comment
	    Return values:
	      COMMENT:Changed
	      COMMENT:Removed
	      COMMENT:comment text information

	   "status" (http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=status)
	    This command will give an overview about the currently started proxies
	    The first line contains the number of started proxies (STATUS_RUNNING:$NUMBER_OF_RUNNING_PROXIES)
	    Subsequent lines contain information about the started proxies, information pieces are separated by ":" (STATUS_PROXY:$EXTERNAL_IP:$PROXY_HOSTNAME:$PROXY_PORT:$PROXY_TYPE:$PROXY_COMMENT:$SECONDS_SINCE_START:$SECONDS_TILL_EXPIRE)
	    For example: STATUS_PROXY:1.2.3.4:proxy.seo-proxies.com:10000:http:some comment text:60:21000
	    The parameter "&human=1" can be added to receive a human readable status report with reduced information. 
	    Please note: more information might be added by future API versions.


	   "proxy_protocol" (http://seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=proxy_protocol&procotol=)
            This command allows to change the proxy protocol. Valid options are "http", "socks" and "vpn".
            The parameter &protocol= is required, otherwise the command will fail with an error
            Please note: This command will only change the protocol setting, currently active proxies will not change their protocol.
             It is required to use the "rotate" or "stop" and "start" commands to change the protocol of a running proxy process
            Return values:
             ERROR:601:unknown type
             PROXY_PROTOCOL:CHANGED:please restart or rotate proxy processes   

     To detect you external IP we offer this free script: http://squabbel.com/ipxx.php , it will return back your current IP address.
     See the php CURL example below as example. The same code can easily be converted into C,C++ or similar programming languages.
	    
	   The commands for activating IPs from the "subnet pool" are currently not supported for customers, this might be useful for resellers in future.

		Example source code
	
		 PHP code for a new professional Google Rank Scraper with local country/language result support 
		 Scraping Google Ranks for Fun and Profit

		 PHP code for a multipage and keyword expanding Google search result scraper 
		 Scraping Google for Fun and Profit


		 Premium tool: a professional Digg bot including Captcha solving written in C++                                                               
		 Tiny Digg Bot
		 
		 
		 API code for a PHP script to rotate/start a proxy: 
		 /* 
 * This function takes one argument (only "rotate" supported) to be submitted to the API.
 *
 * On success it will define the (global) $PROXY variable, adding the elements [ready],[address],[port],[external_ip] and return 1
 * On failure the return code is <= 0 and the $PROXY variable ready element is set to "0"
 */
 
function extractBody($response_str)
{
        $parts = preg_split('|(?:\r?\n){2}|m', $response_str, 2);
        if (isset($parts[1])) return $parts[1];
        return '';
}
function proxy_api($cmd)
{
        $pwd="d24479f7966bddb4e57451b8e35bb16d";
        $uid=-1;
        
        global $PROXY;
        global $NL;
        $fp = fsockopen("www.seo-proxies.com", 80);
        if (!$fp) 
        {
                echo "Unable to connect to proxy API $NL";
                return -1; // connection not possible
        } else 
        {
                if ($cmd == "rotate")
                {
                        $PROXY['ready']=0;
                        fwrite($fp, "GET /api.php?api=1&uid=$uid&pwd=$pwd&cmd=rotate&randomness=1 HTTP/1.0\r\nHost: www.seo-proxies.com\r\nAccept: text/html, text/plain, text/*, */*;q=0.01\r\nAccept-Encoding: plain\r\nAccept-Language: en\r\n\r\n");
                        stream_set_timeout($fp, 8);
                        $res="";
                        $n=0;
                        while (!feof($fp)) 
                        {
                                if ($n++ > 4) break;
                                $res .= fread($fp, 8192);
                        }
                        $info = stream_get_meta_data($fp);
                        fclose($fp);
        
                        if ($info['timed_out']) 
                        {
                                echo 'API: Connection timed out! $NL';
                                return -2; // api timeout
                  } else 
                        {
                                if (strlen($res) > 1000) return -3; // invalid api response (check the API website for possible problems)
                                $data=extractBody($res);
                                $ar=explode(":",$data);
                                if (count($ar) < 4) return -100; // invalid api response
                                switch ($ar[0])
                                {
                                        case "ERROR":
                                                echo "API Error: $res $NL";
                                                return 0; // Error received
                                        break;
                                        case "ROTATE":
                                                $PROXY['address']=$ar[1];
                                                $PROXY['port']=$ar[2];
                                                $PROXY['external_ip']=$ar[3];
                                                $PROXY['ready']=1;
                                                return 1;
                                        break;
                                        default:
                                                echo "API Error: Received answer $ar[0], expected \"ROTATE\"";
                                                return -101; // unknown API response
                                }
                        }
                } // cmd==rotate
        }
}

		 
		 
		 Example code for a console PHP script to test the external IP after rotation:
		 /*
 * This function either returns the external IP or 0 in case of an error
 * The function: proxy_api("rotate"); will define the required $PROXY variable
 */
function getip()
{
    global $PROXY;
    if (!$PROXY['ready']) return -1; // proxy not ready
    
    $curl_handle=curl_init();
    curl_setopt($curl_handle,CURLOPT_URL,'http://squabbel.com/ipxx.php'); // this site will return the plain IP address, great for testing if a proxy is ready
    curl_setopt($curl_handle,CURLOPT_CONNECTTIMEOUT,10);
    curl_setopt($curl_handle,CURLOPT_TIMEOUT,10);
    curl_setopt($curl_handle,CURLOPT_RETURNTRANSFER,1);
    $curl_proxy = "$PROXY[address]:$PROXY[port]";
    curl_setopt($curl_handle, CURLOPT_PROXY, $curl_proxy);
    $tested_ip=curl_exec($curl_handle);

    if(preg_match("^([1-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\.([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])){3}^", $tested_ip))
    {
        curl_close($curl_handle);
        return $tested_ip;
    }
    else
    {
        $info = curl_getinfo($curl_handle);
        curl_close($curl_handle);
        return 0; // possible error would be a wrong authentication IP
    }
}

		 
		 
		 
		 Example code for an imacros - myspace account creation script
		 /*
 * iMacros demo code, targeted for the free Firefox iMacros addon
 * This code is mainly a demonstration and not a complete tool
 * This script does the following:
 * a) prompt user for some basic variables to enter
 * b) loop for all entered account names
 * c) rotate the seo-proxies.com proxy for each loop
 * d) fills out a signup page
 * e) prompts for a captcha 
 * f) submits the account page and optionally clears all cookies
 *
 * This script is mainly a demonstration to show how to use javascript embedded iMacros code and integrate the seo-proxies.com API
 * Useful additions could be: error checking, successful account logging, testing of the proxy ip before start, reading data (names,passwords, etc) from local files, multiple captcha entries, ...
 * 
 * LICENSE: Copyright by http://www.seo-proxies.com !
 * Use and modification of this source code for personal and commercial purposes is allowed for every customer of www.seo-proxies.com
 *
 */

// Your browser needs to be ready to use the proxy (proxy.seo-proxies.com on your first proxy port, please refer to the "Info" of a started proxy or the API documentation)
var api_hash="0000000000000000000000";
var api_id="00";

var jsNewLine="\n"
var filloutcode = "CODE:";
var account_num;
var account_list;
var name_list;
var name_count;
var num;
var rounds;
var tab_index;
var captcha;

var password="asdfg67";


rounds_pause=plani_num=window.prompt("Delay between account creation in seconds","1");
tab_index=window.prompt("Tab selection\n Which tab do you want to use ?","1");
account_names=window.prompt("Enter email names","mail,mail,mail,...");
full_names=window.prompt("Enter same amount of full_names","name1,name2,name3,...");
full_names=full_names.replace(" ","<SP>");

account_list=account_names.split(",");
account_num=account_list.length;	
name_list=full_names.split(",");
name_count=name_list.length;	
if (name_count != account_num) alert("Wrong count of names and mails, will cause errors.");
alert("Creating "+account_num+" gmail accounts")


for (rounds=0;rounds < account_num;rounds++) {

// ========== Rotate seo-proxies.com proxy to a new IP =========
	var http = false;
	var wait_rotate=1;
	var max_rotate=10;
	
	if(navigator.appName == "Microsoft Internet Explorer") {
	  http = new ActiveXObject("Microsoft.XMLHTTP");
	} else {
	  http = new XMLHttpRequest();
	}
	http.open("GET", "http://seo-proxies.com/api.php/?api=1&uid="+api_id+"&pwd="+api_hash+"&cmd=rotate");
	http.onreadystatechange=function() {
	  if(http.readyState == 4) {
	    //alert("API response: "+http.responseText);
	    wait_rotate=0;
	  }
	}
	http.send(null);
	
	// wait for rotation
	while ( wait_rotate ) {
		iimPlay("CODE:VERSION BUILD=6240709"+jsNewLine+"WAIT SECONDS=1");
		if (!max_rotate--) {
			alert("API connection failing,script abortion");
			break;
		}
	}
	if (wait_rotate) break;
	// ============= Fill out the google mail page ================
	
	
	filloutcode = "CODE:VERSION BUILD=6240709" + jsNewLine
	filloutcode = filloutcode + "SET !ERRORIGNORE YES" + jsNewLine // ignore missing fields, this helps to trick the security
	filloutcode = filloutcode + "SET !TIMEOUT 15" + jsNewLine // 15 seconds timeouts on commands
	filloutcode = filloutcode + "CLEAR" + jsNewLine   // clears all cookies
	filloutcode = filloutcode + "SET !REPLAYSPEED FAST" + jsNewLine
	if (tab_index > 1)
		filloutcode = filloutcode + "TAB OPEN" + jsNewLine
	filloutcode = filloutcode + "TAB T="+ tab_index + jsNewLine
	filloutcode = filloutcode + "URL GOTO=http://signups.myspace.com/index.cfm?fuseaction=signup" + jsNewLine
	filloutcode = filloutcode + "SET !TIMEOUT" + jsNewLine // no timeout for form filling
	filloutcode = filloutcode + "TAG POS=1 TYPE=A ATTR=TXT:Sign<SP>Up" + jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:TEXT FORM=NAME:aspnetForm ATTR=ID:Email CONTENT=" + account_list[rounds] + jsNewLine
	filloutcode = filloutcode + "SET !ENCRYPTION NO" + jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:PASSWORD FORM=NAME:aspnetForm ATTR=ID:Password CONTENT=" + password + jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:TEXT FORM=NAME:aspnetForm ATTR=ID:FullName CONTENT=" + name_list[rounds] + jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=SELECT FORM=NAME:aspnetForm ATTR=ID:Day CONTENT=%3" +  jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=SELECT FORM=NAME:aspnetForm ATTR=ID:Month CONTENT=%8" +  jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=SELECT FORM=NAME:aspnetForm ATTR=ID:Year CONTENT=%1977" +  jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:RADIO FORM=ID:aspnetForm ATTR=ID:genderF" +  jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:CHECKBOX FORM=NAME:aspnetForm ATTR=ID:Terms CONTENT=YES" +  jsNewLine
	filloutcode = filloutcode + "SET !TIMEOUT 15" + jsNewLine // 15 seconds timeouts on commands
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:SUBMIT FORM=ID:aspnetForm ATTR=ID:ctl00_ctl00_ctl00_cpMain_cpMain_cpMain_Submit_Express_SubmitButton" +  jsNewLine
	filloutcode = filloutcode + "PROMPT Captcha: !VAR1" +  jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:TEXT FORM=NAME:aspnetForm ATTR=ID:captchaResponseTextBox CONTENT={{!VAR1}}"  +  jsNewLine
	filloutcode = filloutcode + "TAG POS=1 TYPE=INPUT:SUBMIT FORM=ID:aspnetForm ATTR=ID:ctl00_ctl00_ctl00_cpMain_cpMain_cpMain_Submit_Express_SubmitButton" +  jsNewLine
	
	iimPlay(filloutcode)
	
	// pause as requested by user
	iimPlay("CODE:VERSION BUILD=6240709"+jsNewLine+"WAIT SECONDS="+rounds_pause) 
	
	// continue with next account or end script
}
		 
		 
		 
Support for CLAD Genius


CLAD Genius supports automated proxy rotation through the seo-proxies.com API

There is no need for hacks and scripts anymore, all you need to do is to follow these simple instructions:

1. Start Clad Genius and click the configuration Icon on the upper right side
2. Go to the section "seo-proxies" and activate the checkbox.
3. Enter your userid (-1) and api password (d24479f7966bddb4e57451b8e35bb16d) into the two fields
4. Click the "Test" button, it should now obtain one IP from your pool and start it
5. Now head to the configuration of account creation and ad posting and setup seo-proxies as 1st proxy-rotation method
(In settings, you have to go to Posting>Craigslist>Internet and then click on Change to set up the proxy priority rotation.)
That's it, now CLAD G. is using your exclusive proxies
Make sure NOT to use "USA" as Entry-proxy. Use the default "Europe" proxy for Clad-G and similar tools