flags.es - Flag Counter

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:

4. Response

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

Example Response:

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

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