Gul.ly

The Deep Gul.ly REST API

Gul.ly is a URL shortening service. The Gul.ly REST API provides a way for you to programmatically shorten URLs with gully for your own applications.

---

---

---

• Request Scheme:
  

       http://gul.ly/?url=〈YourURL〉&api=〈true〉&format=〈YourFavFormat〉&callback=〈YourFavCallbackFunctionName〉

• Real Live Example:

       http://gul.ly/?url=http://bocoup.com&api=true&format=json&callback=droppedInTheGully

• Paramaters
  • url: The url you want to drop into the Gul.ly [Required]
  • api: The parameter that tells Gul.ly not to just send you to the human readable shortened url page [Required]
  • callback: Optional name for javascript callback function if format=json [Optional]
  • format: The available json & xml values return JSON & XML respectively. Otherwise Plain text is returned. Both original & shortened urls are returned to json & xml requests. Only the shortened url is returned to plain text requests. [Optional]

    ---

    • JSON Response Example:
      

      
      	droppedInTheGully(){
      	  longURL : "http://bocoup.com";
      	  shortURL : "http://gul.ly/p"
      	}
      
      

    • XML Response Example:
      

      
      	<gully>
      	  <url>
      	    <longurl>http://bocoup.com</longurl>
      	    <shorturl>http://gul.ly/p</shorturl>
      	  </url>
      	</gully>
      
      

    • Unspecified (Plain Text): Response Example
      

      
      	http://gul.ly/p
      
      

---

---

---

---

---

---

---

---