beta
  • Over 150.000 photos!
  • Over 7,310,000 locations!


Glosk API

em português      

AddThis Social Bookmark Button
>>> Will be available in a couple of days - stay tuned.

Many people has been contacting us about how to interact with glosk database in a developer kind of way. So, here it is ;)

With Glosk API, you can search our database using XML-RPC calls. There is no limit for daily requests, but keep in mind that Glosk API is freely available only for non-commercial use. Commercial use is possible but by prior arrangement.

An Overview

The Glosk API consists of a set of callable methods. To perform an action using the Glosk API, you need to send a request to http://www.glosk.com/services/api/ specifying a method and some arguments, and will receive a formatted response. The arguments, responses and error codes for each method are listed below.

Data Encoding

The Glosk API expects all data to be UTF-8 encoded. Sending data in any other encoding will result in garbage into Glosk. It wont be dangerous garbage (we will always store valid UTF-8) but it will still be garbage.

More information about UTF-8

API Keys

To use the Glosk API you need to have an application key. We use this to track API usage.

Currently, commercial use of the API is allowed only with prior permission. Requests for API keys intended for commercial use are reviewed by staff. If your project is personal, artistic, free or otherwise non-commercial please don't request a commercial key. If your project is commercial, please provide sufficient detail to help us decide. Thanks!

If you are insterested, apply for a key now, and please make sure you include a brief explanation of how you're planning to use it.

API Methods

Below is a list of all methods that you can call using Glosk API. Click in a method name to see more information about it. If you need a special method, please contact us and we will try to do it for you.

places

  • glosk.places.search
  • glosk.places.getInfo
  • glosk.places.getPhotos
  • glosk.places.getPages
  • glosk.places.getMap
  • glosk.places.getNearbyPlaces

countries

  • glosk.countries.getList
  • glosk.countries.getDetails

dsg codes

  • glosk.dsg.getList
  • glosk.dsg.getDetails

latest

  • glosk.latest.getPhotos
  • glosk.latest.getSearches
  • glosk.latest.getPages