Skip to content
Permalink
master
Go to file
2 contributors

Users who have contributed to this file

@jmeattle @Simplify
92 lines (69 sloc) 2.12 KB

URL Shortener API

Use the URL Shortener API to shorten any link using a shortening service that you specify.

https://www.shareaholic.com/v2/share/shorten_link

?url=       (required; example: http://www.google.com/)
&service=   (optional; tinyurl | bitly | jmp | shrlc)
&api_key=   (optional)
&login=     (optional)

Example 1:

https://www.shareaholic.com/v2/share/shorten_link?url=http://google.com/&service=shrlc

Success result:

{
  "status_code": "200",
  "data": "https://go.shr.lc/2sZ8JZo"
}

🔗Try Me: Shorten URL - http://google.com

You can further customize this option with your own bitly key if you'd like by passing in an additional api_key and/or login parameters. If you pass this, the URL Shortener API will use your key to shorten the link.

Example 2 (with custom key):

https://www.shareaholic.com/v2/share/shorten_link?url=http://google.com/&service=bitly&api_key=[INSERT YOUR BITLY API KEY]&login=[INSERT YOUR BITLY LOGIN]

Success result:

{
  "status_code": "200",
  "data": "http://bit.ly/18yU7Q9"
}

Error result:

{
  "errors": [
    {
      "code": "150",
      "source": {
        "pointer": "/data/attributes/url"
      },
      "detail": "Invalid or no URL provided"
    }
  ]
}

Safety

URL Shortener API also checks if the provided URL is safe or not with the help of Google Safe Browsing. In the case of unsafe URL, you will receive original URL and message that indicates why the URL is not safe.

For example:

https://shareaholic.com/v2/share/shorten_link?url=http://testsafebrowsing.appspot.com/apiv4/ANY_PLATFORM/MALWARE/URL/&service=google

Result:

{
  "errors": [
    {
      "code": "145",
      "source": {
        "pointer": "/data/attributes/short-url"
      },
      "detail": "Unsafe URL: Malware (Any platform)"
    }
  ]
}

List of possible error codes:

  • 145 - URL shortening problem or unsafe URL
  • 150 - Invalid or no url provided
You can’t perform that action at this time.