To assist in User Interface building, we offer the get_city_like method which will return information for cities which names start with a given string, within a given country.

* The value for country can be either the country’s exact name or ID, as returned from get_country_like

Example:

http://api.cronblocks.com/get_city_like.html?api_key=1234567890abcdef&country=brazil&city=rio+de

Returns:

{"api_name":"get_city_like","status":"SUCCESS","data":[{"city_id":"90244","city":"Rio De Janeiro","region_name":"Rio de Janeiro"}]}

To assist in User Interface building, we offer the get_city_index method which will return the first letter of all cities in our database for a given country.

* The value for country can be either the country’s exact name or ID, as returned from get_country_like

Example:

http://api.cronblocks.com/get_city_index.html?api_key=1234567890abcdef&country=brazil

To assist in User Interface building, we offer the get_country_like method which will return information for countries which names start with a given string. The string provided must be at least 3 characters long.

Example:

http://api.cronblocks.com/get_country_like.html?api_key=1234567890abcdef&country=bra

Returns:

{"api_name":"get_country_like","status":"SUCCESS","data":[{"country_id":"35","country_code":"BR","country_name":"Brazil","has_cities":"1"}]}

To assist in User Interface building, we offer the get_country_index method which will return the first letter of all countries in our database.

Example:

http://api.cronblocks.com/get_country_index.html?api_key=1234567890abcdef&data_type=json

The GeoIP method is used to fetch a geographic location from a given IP. The number of allowed requests per month depends on the caller’s plan:

If the maximum number of requests is reached, an ERROR response with the appropriate message will be returned.

Example:

http://api.cronblocks.com/geoip.html?api_key=1234567890abcdef&ip=210.210.210.210&data_type=json

Use the Sign Up method to create a new Cronblocks FREE account. The new account will be connected to your own account for affiliate purposes (when we get around to setting that up).

Example:

http://api.cronblocks.com/sign_up.html?api_key=1234567890abcdef&email=foo@example.com&password=secretpass&domain=example.com&data_type=json

To begin using Cronblocks.com’s API, you need to first get your API key. API keys are unique to each user and can be found under the Profile section of the Admin Interface.

Input/Output Formats

Cronblocks.com uses REST to communicate with third parties. Methods which present data will only accept GET requests, while methods which change data require POST requests. Check the individual method documentation to see which one to use.

Output format can be specified by the caller through the data_type input parameter. Accepted values are: JSON (default) and XML. Case insensitive. The output format will vary according to SUCCESSful or ERRORed results.

For ERROR replies, a typical JSON output will be as follows:

{"status":"ERROR","msg":"Some Error Message"}

Its XML counterpart will be:

<?xml version="1.0"?>
<api_name>
    <status>ERROR</status>
    <msg>Some Error Message</msg>
</api_name>

For SUCCESS replies, there will be a status section and a data section. The data section will vary according to the API called. A typical Sign Up call would yield:

{"api_name":"sign_up","status":"SUCCESS","data":{"user_id":1}}

or

<?xml version="1.0"?>
<sign_up>
    <status>SUCCESS</status>
    <data>
        <api_key>abcdefghi123435</api_key>
    </data>
</sign_up>

See available methods in the sidebar menu.

Have a look at the documentation to find out more!

Cheers,
Vinny