Shorten long URLs and deliver a great reading view with a single, unique
URL using the Shortener API.
samson@readability:~/developers/api/shortener
#
No Authentication is required.
Here's how to create a new shortened URL:
POST /api/shortener/v1/urls Content-Type: application/x-www-form-urlencoded url=http://blog.arc90.com/2010/11/30/silence-is-golden/
HTTP/1.0 200 OK
{
"meta": {
"url": "/api/shortener/v1/urls/tg8if9uj",
"rdd_url": "http://rdd.me/tg8if9uj",
"id": "tg8if9uj"
},
"messages": [
"URL shortened."
],
"success": true
}
All requests are provided as JSON.
available response representations:
| parameter | value | description |
|---|---|---|
url | string (required) | The article URL to shorten. |
available response representations:
potential faults:
available response representations:
potential faults:
{
"resources": {
"urls": {
"href": "/api/shortener/v1/urls",
"description": "The URLs endpoint. POST a URL to add it to the shortener"
}
}
}
{
"meta": {
"url": "/api/shortener/v1/urls/tg8if9uj",
"rdd_url": "http://rdd.me/tg8if9uj",
"id": "tg8if9uj"
},
"messages": [
"URL shortened."
],
"success": true
{
"meta": {
"article": {
"url": "http://blog.arc90.com/2010/11/30/silence-is-golden/",
"author": "Tim Meaney",
"excerpt": "It is a mostly well-known fact, yet nearly...",
"word_count": 1126,
"title": "Silence is Golden"
},
"rdd_url": "http://rdd.me/tg8if9uj",
"id": "tg8if9uj",
"full_url": "http://readability.com/articles/tg8if9uj"
},
"messages": [
"Article found."
],
"success": true
}