Really Very Good

Beta! Really.VeryGood A URL shortener for very good links

API

Really.VG has an API that can be used by third party applications to create and interrogate links.

Create a new short URL

http://really.vg/shorten/

Parameters
Name	Description	Required?
`url`	The long URL that is to be shortened.	Mandatory
`output`	Specifies the output format that you wish to receive. Possible values are: `text`, `xml`, `json`	Mandatory
`custom`	A custom tag for the URL that will be used instead of the system generating a random one.	Optional
`grouptag`	A tag that may be used to group a number of shortened URLs together. This is not a tag that will be used in the trending tags section.	Optional
`comment`	A comment that can be stored against the shortened URL.	Optional
`tags`	A space-separated list of tags (words) that the created URL will be tagged with.	Optional

Examples

Request: http://really.vg/shorten/?output=text&url=http://google.com/
Response: aBc123 http://google.com/

Request: http://really.vg/shorten/?output=xml&url=http://google.com/
Response: <?xml version='1.0'?><reallyvg><shortcode>aBc123</shortcode><url><![CDATA[http://google.com/]]></url></reallyvg>

Request: http://really.vg/shorten/?output=json&url=http://google.com/
Response: {"shortCode":"aBc123","url":"http://google.com/"}

Get short URL information

http://really.vg/show/XXXXXX

...where XXXXXX is the short code.

Parameters
Name	Description	Required?
`output`	Specifies the output format that you wish to receive. Possible values are: `text`, `xml`, `json`	Mandatory

Examples

Request: http://really.vg/show/aBc123?output=text
Response: http://google.com/

Request: http://really.vg/show/aBc123?output=xml
Response: <?xml version='1.0'?><reallyvg><shortcode>aBc123</shortcode><url><![CDATA[http://google.com/]]></url></reallyvg>

Request: http://really.vg/show/aBc123?output=json
Response: {"shortCode":"aBc123","url":"http://google.com/"}

Get short URL information for a group tag

http://really.vg/group/XXXXXX

...where XXXXXX is the group tag.

Parameters
Name	Description	Required?
`output`	Specifies the output format that you wish to receive. Possible values are: `text`, `xml`, `json`	Mandatory

Examples

Request: http://really.vg/group/searchengines?output=text
Response:

aBc123 http://google.com/
DeF456 http://yahoo.com/

Request: http://really.vg/group/searchengines?output=xml
Response:

<?xml version='1.0'?> <reallyvg> <link><shortcode>aBc123</shortcode><url><![CDATA[http://google.com/]]></url></link> <link><shortcode>DeF456</shortcode><url><![CDATA[http://yahoo.com/]]></url></link> </reallyvg>

Request: http://really.vg/show/aBc123?output=json
Response: [{"shortCode":"aBc123","url":"http://google.com/"},{"shortCode":"DeF456","url":"http://yahoo.com/"}]

Get short URLs that been tagged

http://really.vg/tag/XXXXXX

...where XXXXXX is the tag.

Parameters
Name	Description	Required?
`output`	Specifies the output format that you wish to receive. Possible values are: `text`, `xml`, `json`	Mandatory

Examples

Request: http://really.vg/tag/news?output=text
Response:

GhI789 http://cnn.com/
jKl101 http://news.bbc.co.uk/

Request: http://really.vg/tag/news?output=xml
Response:

<?xml version='1.0'?> <reallyvg> <link><shortcode>GhI789</shortcode><url><![CDATA[http://cnn.com/]]></url></link> <link><shortcode>jKl101</shortcode><url><![CDATA[http://news.bbc.co.uk/]]></url></link> </reallyvg>

Request: http://really.vg/tag/news?output=json
Response: [{"shortCode":"GhI789","url":"http://cnn.com/"},{"shortCode":"jKl101","url":"http://news.bbc.co.uk/"}]