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

• API documentation
  • Introduction
  • General information
  • Using the API
• 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
	or have got written permission to do so.
	Hint: When configuring a tool, browser or script make sure you add our domain (www.seo-proxies.com) as proxy exception
	
	
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 HTTP or the SOCKS protocol. You can switch the protocol in your profile at any time.
	All proxies run on the host "proxy.squabbel.com" , your first proxy port is 7999 .
	It might look complicate in the first place but actually it is very easy: 
	You simply configure proxy.squabbel.com:7999 as HTTP 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 lifetime of 7 hours, after that you have to start it again.
	
	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.
	
	
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://www.seo-proxies.com/api.php?api=1&uid=-1&pwd=d24479f7966bddb4e57451b8e35bb16d&cmd=

	API commands
	
	"hello" (http://www.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.
	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
	If the license is not ready it will return "ERROR:$code:$reason" or "HELLO:0:0"
	
	
	 "rotate" (http://www.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.squabbel.com:$port and has the external IP $IP_ADDRESS
	  	
	  "start" (http://www.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.squabbel.com:$PORT
	     
	
	   "stop" (http://www.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://www.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 on 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://www.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)
	    For example: STATUS_PROXY:1.2.3.4:proxy.squabbel.com:10000:http:some comment text:60
	    Please note: more information might be added by future API versions.

   
     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 professional 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) goes into a loop for all entered account names
 * c) rotate the seo-proxies.com proxy for each loop
 * d) fills out the myspace signup page
 * e) prompts for a captcha (soon seo-proxies.com will offer multiple homed captcha solving to automate this step)
 * 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.squabbel.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
     
	

This website is intellectual property by international copyright law. Reproducing content from this webpage in any form requires written permission from the (c) owners. Contact   TOS and AUP