As of March 30, 2019, the URL shortener was shut down. Please see this blog post for alternatives.

Url: get

The url.get method gets expansion information for a specified short URL. Try it now.

For the given short URL, the url.get method returns the corresponding long URL and the status.

This method requires two query parameters:

  • Your API key (using the key query parameter).
  • The short URL (using the shortUrl query parameter). Note: The short URL should include the protocol, e.g. "".

It also supports an optional query parameter:
  • Additional information to return (using the projection query parameter). Possible values are:
    • "FULL" - returns the creation timestamp and all available analytics
    • "ANALYTICS_CLICKS" - returns only click counts
    • "ANALYTICS_TOP_STRINGS" - returns only top string counts (e.g. referrers, countries, etc)

Note that with the projection parameter, analytics might not be returned if data is currently unavailable.


HTTP Request



Parameter Name Value Description
Required Parameters
shortUrl string The short URL, including the protocol.
Optional Parameters
projection string Additional information to return.

Acceptable values are:
  • "ANALYTICS_CLICKS" - Returns only click counts.
  • "ANALYTICS_TOP_STRINGS" - Returns only top string counts.
  • "FULL" - Returns the creation timestamp and all available analytics.

Request Body

Do not supply a request body with this method.


If successful, this method returns an Url resource in the response body.

Try It!

Use the explorer below to call this method on live data and see the response. Alternatively, try the standalone explorer.