Flag Counter @ flags.es - API Documentation

API Documentation for Flags.es

1. Endpoint

The Base Url for every Api Call is:

http://www.flags.es/cgi-bin/geoip/amiip.pl

2. Parameters

Following Parameters can be passed to the Endpoint:

Description | Parameter | Default Value | Maximum Value , optional Description

Number of Visitors to Display | v | 3 | 500
Link Colour (Hexadecimal Colour Code) | l | 000000 | -
Text Colour (Hexadecimal Colour Code) | t | 000000 | -
Body Colour (Hexadecimal Colour Code) | c | FFFFFF | - , ( can be the Value ' transparent ' )
Border Colour (Hexadecimal Colour Code) | b | 000000 | - , ( can be the Value ' transparent ' )
Number of Columns | d | 0 | -
Font Size | s | 13 | -
Width in Pixel | w | 200 | -
Height in Pixel | h | 430 | -
Show absolute Visitors Counter | sc | 1 | - , ( 1 = Display , 2 = No Display )
Time in Seconds an existing IP wont be counted as an new Visit | to | 30 | - , ( Set to 1 for an Hit Count )
Set an Background Image Url | i | - | - , ( absolute Url to an Graphic File, optional )
Repeat the Background Image | r | 1 | - , ( 1 = Repeat , 2 = No Repeat )
Switch the Display Mode | m | v | - , ( v = display Visitors , c = display Countries )
Referrer to calling Page | ref | - | - , ( Referring Url to the Page calling the Endpoint Script, optional )
Calling Url | curl | - | - , ( Calling Url, mandatory )
Calling IP | cip | - | - , ( Calling IP, can be defined, as well as the IP is determined dynamically to make some Sense, optional )

3. Example Call

An Example for an Call to the flags.es Api:

http://www.flags.es/cgi-bin/geoip/amiip.pl?v=13&l=000000&t=000000&c=FFFFFF&b=000000&d=1&s=13&w=225&h=285&sc=1&to=30&i=&r=1&m=v&ref=http://www.amidalla.de&curl=http://www.flags.es&cip=98.137.236.24

4. Response

The Response to an Call to the Api will be in HTML, this can be displayed as is or parsed.

Example Response:

<html><head><script type="text/javascript">function mafo ( mode , width, height, lat, long ) { var winwidth = width + 30; var winheight = height + 30; var map_div = "<div id=\"mf\" style=\"border: 1px solid #000000; padding: 4px; background-color: #FFFFFF; overflow: hidden; position:absolute; visibility:visible; color: #000000; font: 13px arial\">"; if ( mode == 2 ) { var googleMap = "<img src=\"http://maps.google.com/maps/api/staticmap?markers="+lat+","+long+"&zoom=6&size="+width+"x"+height+"&sensor=false\">"; var mfwin = window.open("", "flagsES", "width="+winwidth+", height="+winheight+", resizable=yes, left=20, top=20"); mfwin.document.write(map_div+googleMap+"</div>"); } if ( mode == 4 ) { var mfwin = window.open("http://www.flags.es/cgi-bin/geoip/amiip_cc.pl?rd=flags.es", "flagsES", "width="+winwidth+", height="+winheight+", resizable=yes, left=20, top=20, scrollbars=yes"); } }</script></head><body bgcolor='#FFFFFF'><center><div id="amigeoipDiv" style="margin: 0px; border: 1px solid #000000; padding: 2px; background-color: #FFFFFF; background-image: none; background-repeat: repeat; overflow: hidden; height: 285px; width: 225px; color: #000000; font: 13px arial; text-align:left;"><table border=0 cellpadding=0 cellspacing=0><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px;"><a href="http://www.flags.es/" target="_blank" title="flags.es - Information & create your own Counter"><img src="http://www.flags.es/geoip/code_button_small.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 0:0:0 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 0:1:7 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 0:4:31 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 0:5:25 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 0:6:45 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 0:12:22 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/PL.gif" border=0 title="Poland - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,50.0833,19.9167);" style="color: #000000" title="Show City on Map">Kraków</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 0:55:5 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 1:9:1 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.0167,11.6833);" style="color: #000000" title="Show City on Map">Brunnthal</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 1:11:27 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/US.gif" border=0 title="United States - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,37.5473,-120.6813);" style="color: #000000" title="Show City on Map">Denair</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 1:29:46 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.5167,12.4167);" style="color: #000000" title="Show City on Map">Gerzen</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 1:38:50 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/DE.gif" border=0 title="Germany - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,48.5167,12.4167);" style="color: #000000" title="Show City on Map">Gerzen</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 1:41:12 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;"><a href="javascript:mafo(4,650,600,0,0);"><img src="http://www.flags.es/geoip/flags/US.gif" border=0 title="United States - display all Countries & Cities"></a> <a class="amigeoiplinks" href="javascript:mafo(2,600,680,42.9967,-87.9879);" style="color: #000000" title="Show City on Map">Milwaukee</a>, <img src="http://www.flags.es/geoip/clock.png" border=0> 2:54:52 ago. <a href="http://www.flags.es/" target="_blank" title="visited http://www.flags.es/"><img src="http://www.flags.es/geoip/link.png" border=0></a></span></td></tr><tr valign='top'><td><span style="text-align: left; padding: 2px; margin: 2px; color: #000000; font: 13px arial;">Visitors: 16926</span></td></tr><tr valign='top'></tr></table></div></center></body></html>

Displays as unparsed HTML:

Brunnthal,

0:0:0 ago.

Brunnthal,

0:1:7 ago.

Brunnthal,

0:4:31 ago.

Brunnthal,

0:5:25 ago.

Brunnthal,

0:6:45 ago.

Brunnthal,

0:12:22 ago.

Kraków,

0:55:5 ago.

Brunnthal,

1:9:1 ago.

Brunnthal,

1:11:27 ago.

Denair,

1:29:46 ago.

Gerzen,

1:38:50 ago.

Gerzen,

1:41:12 ago.

Milwaukee,

2:54:52 ago.

Visitors: 16926

Flag Counter @ flags.es - free Flag Counter for your Website and Blog

This product includes GeoLite data created by MaxMind, available from http://www.maxmind.com/.
info@amidalla.com, Holger Deschakovski, Seilerstr. 6, 85051 Ingolstadt