Bubble | No-code apps

TinyURL PRO

URL Shortener, Branded Short Links & Analytics
Available Actions [Comes with TinyURL Free Plan]
Create TinyURL
Update TinyURL
Get TinyURL info
Get TinyURLs
Get TinyURLs Count
Toggle TinyURL Archive
Available Actions [Requires TinyURL Paid Plan]
Change TinyURL [PRO]
Delete TinyURL [PRO]
Change TinyURL Analytics Collecting [PRO]
Change TinyURL Analytics Sharing [PRO]
Get Raw Analytics Logs [PRO]
Get TImeline Analytics [PRO]
Get General Analytics [PRO]
Get Top Sources Analytics [PRO]
Get Top Languages Analytics [PRO]
Create TinyURL
Take a long URL and shorten it into a new TinyURL.
Parameters
url (Required): URL to shorten
domain (Optional): For Paid Plans [use your own custom domains instead of default]

alias (Optional): Define your custom alias [leave blank to generate random]

tags (Optional): Add Tags seperated by comma [example: shop,link]

expires_at (Optional): Define your own link expiration date [leave blank for default]

description (Optional): Add an optional Description
Response
{     "body": {         "data": {             "domain": "tinyurl.com",             "alias": "example-alias",             "deleted": false,             "archived": false,             "tags": [
                "tag1"
            ],             "analytics": {                 "enabled": true,                 "public": false             },             "tiny_url": "https://tinyurl.com/example-alias",             "created_at": "2022-11-24T19:41:23+00:00",             "expires_at": "2022-11-24T19:41:23+00:00",             "url": "http://google.com"         },         "code": 0,         "errors": [
            ""
        ]     },     "error": {         "status_code": 200,         "status_message": "OK",         "body": ""     },     "returned_an_error": false }
Update TinyURL
Update TinyURL alias, tags, stats settings
Parameters
alias (Required): Your original alias with which you created the TinyURL.
domain (Optional): Your original domain with which you created the TinyURL [default is tinyurl.com]

new_domain (Optional): Your new domain to update the TinyURL to [default is tinyurl.com]

new_alias (Optional): Your new alias for previous TinyURL.

new_stats (Optional): Set TinyURL Stats [true or false]

new_tags (Optional): Add new tags seperated by comma [example: shop,link]

new_expires_at (Optional): update link expiration date.

new_description (Optional): Add a new Description.
Response
{     "body": {         "data": {             "domain": "tinyurl.com",             "alias": "example-alias",             "deleted": false,             "archived": false,             "tags": [
                "tag1"
            ],             "analytics": {                 "enabled": true,                 "public": false             },             "tiny_url": "https://tinyurl.com/example-alias",             "created_at": "2022-11-24T19:41:23+00:00",             "expires_at": "2022-11-24T19:41:23+00:00",             "url": "http://google.com"         },         "code": 0,         "errors": [
            ""
        ]     },     "error": {         "status_code": 200,         "status_message": "OK",         "body": ""     },     "returned_an_error": false }
Change TinyURL [PRO]
Update TinyURL long URL
Parameters
url (Required): New TinyURL long URL to update/replace previous.
alias (Required): Alias you created the TinyURL with.

domain (Optional): Domain you created the TinyURL with [default is tinyurl.com].
Response
{  "body": {    "data": {      "url": "http://google.com"    },    "code": 0,    "errors": [
     ""
   ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
Get TinyURL info
Receive TinyURL information
Parameters
alias (Required): Alias you created the TinyURL with.
domain (Required): Domain you created the TinyURL with [default is tinyurl.com].
Response
{  "body": {    "data": {      "domain": "tinyurl.com",      "alias": "w2wqqwedw2",      "deleted": false,      "archived": false,      "tags": [
       "tag1"
     ],      "analytics": {        "enabled": true,        "public": false      },      "created_at": "2024-12-17T20:30:58+00:00",      "expires_at": "2024-12-17T20:30:58+00:00",      "tiny_url": "https://tinyurl.com/w2wqqwedw2",      "user": {        "email": "saim.hafeez@thechakor.com",        "name": "Saim Hafeez"      },      "team": {        "name": "Team #1",        "slug": "team1"      },      "hits": 0,      "url": "http://www.thechakor.com"    },    "code": 0,    "errors": [
     ""
   ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
Delete TinyURL [PRO]
Deletes the TinyURL
Parameters
alias (Required): Alias you created the TinyURL with.
domain (Required): Domain you created the TinyURL with [default is tinyurl.com].
Response
{  "body": {    "data": {      "domain": "tinyurl.com",      "alias": "example-alias",      "deleted": true,      "archived": false,      "tags": [
       "tag1"
     ],      "analytics": {        "enabled": true,        "public": false      },      "tiny_url": "https://tinyurl.com/example-alias",      "created_at": "2022-11-24T19:41:23+00:00",      "expires_at": "2022-11-24T19:41:23+00:00",      "url": "http://google.com"    },    "code": 0,    "errors": [
     ""
   ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
Get TinyURLs
Get a list of TinyURLs.
Parameters
type (Required) Specifies the type of URLs to query.
Allowed Values:
  • available: Queries URLs that are currently available.
  • archived: Queries URLs that are archived (no longer active).


    • From_Timestamp (Optional): Specifies the starting timestamp for the query range. Only URLs created or updated after this timestamp will be considered.


    TO_Timestamp (Optional): Specifies the ending timestamp for the query range. Only URLs created or updated before this timestamp will be considered.

    search (Optional)
    Allows filtering of URLs based on specific criteria.
    Supported Keys:
  • alias: Filters URLs by their alias. For instance, alias:my-alias checks if there a TinyURL with alias of "my-alias".
  • tag: Filters URLs by their tags. For instance, tag:tag-name checks if there a TinyURL with tag of "tag-name".


    • Response
    {  "body": {    "code": 0,    "data": [      {        "domain": "tinyurl.com",        "alias": "w2wqqwedw2",        "deleted": false,        "archived": false,        "analytics": {          "enabled": true,          "public": false        },        "tags": [
             ""
           ],        "created_at": "2024-12-17T20:30:58+00:00",        "expires_at": "2024-12-17T20:30:58+00:00",        "tiny_url": "https://tinyurl.com/w2wqqwedw2"      }    ],    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
    Get TinyURLs Count
    Get a count of TinyURLs.
    Parameters
    type (Required) Specifies the type of URLs to query.
    Allowed Values:
  • available: Queries URLs that are currently available.
  • archived: Queries URLs that are archived (no longer active).


    • From_Timestamp (Optional): Specifies the starting timestamp for the query range. Only URLs created or updated after this timestamp will be considered.


    TO_Timestamp (Optional): Specifies the ending timestamp for the query range. Only URLs created or updated before this timestamp will be considered.

    search (Optional)
    Allows filtering of URLs based on specific criteria.
    Supported Keys:
  • alias: Filters URLs by their alias. For instance, alias:my-alias checks if there a TinyURL with alias of "my-alias".
  • tag: Filters URLs by their tags. For instance, tag:tag-name checks if there a TinyURL with tag of "tag-name".


    • Response
    {  "body": {    "data": {      "count": 7    },    "code": 0,    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
    Toggle TinyURL Archive
    archive/unarchive TinyURL.
    Parameters
    alias (Required): Alias you created the TinyURL with.
    domain (Required): Domain you created the TinyURL with [default is tinyurl.com].
    Response
    {  "body": {    "data": {      "domain": "tinyurl.com",      "alias": "w2wqqwedw2",      "deleted": false,      "archived": true,      "analytics": {        "enabled": true,        "public": false      },      "tags": [
           ""
         ],      "created_at": "2024-12-17T20:30:58+00:00",      "expires_at": "2024-12-17T20:30:58+00:00",      "tiny_url": "https://tinyurl.com/w2wqqwedw2"    },    "code": 0,    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
    Change TinyURL Analytics Collecting [PRO]
    Manage TinyURL analytics collecting.
    enabled
    Parameters
    enabled (Required): Specifies whether analytics collection should be enabled or disabled [true or false]
    alias (Required): The alias of the TinyURL for which analytics collection is being managed.

    domain (Required): The domain for which analytics collection is being managed. The default is "tinyurl.com" unless you are using custom domain.
    Response
    {   "body": {     "data": {       "domain": "tinyurl.com",       "alias": "wegie22a",       "deleted": false,       "archived": false,       "tags": [         "tag1"       ],       "analytics": {         "enabled": false,         "public": false       },       "tiny_url": "https://tinyurl.com/wegie22a",       "created_at": "2022-11-24T19:41:23+00:00",       "expires_at": "2022-11-24T19:41:23+00:00"     },     "code": 0,     "errors": [       ""     ]   },   "error": {     "status_code": 200,     "status_message": "OK",     "body": ""   },   "returned_an_error": false }
    Change TinyURL Analytics Sharing [PRO]
    Manage TinyURL analytics sharing.
    public
    Parameters
    public (Required): Specifies whether analytics sharing should be enabled or disabled [true or false]
    alias (Required): The alias of the TinyURL for which analytics sharing is being managed.

    domain (Required): The domain for which analytics sharing is being managed. The default is "tinyurl.com" unless you are using custom domain.
    Response
    {   "body": {     "data": {       "domain": "tinyurl.com",       "alias": "wegie22a",       "deleted": false,       "archived": false,       "tags": [         "tag1"       ],       "analytics": {         "enabled": false,         "public": true       },       "tiny_url": "https://tinyurl.com/wegie22a",       "created_at": "2022-11-24T19:41:23+00:00",       "expires_at": "2022-11-24T19:41:23+00:00"     },     "code": 0,     "errors": [       ""     ]   },   "error": {     "status_code": 200,     "status_message": "OK",     "body": ""   },   "returned_an_error": false }
    Get Raw Analytics Logs [PRO]
    Returns raw analytics logs.
    Parameters
    From_Timestamp (Required): Datetime, indicating start datetime of analytics report. TO_Timestamp (Optional): Datetime, indicating end datetime of analytics report. Will default to current time. TinyURL (Optional): TinyURL to get analytics for.
    tag (Optional): Tag to get analytics for.
    Response
    {  "body": {    "data": [      {        "datetime": "2020-12-21 14:10:00",        "tiny_url": "https://tinyurl.com/alias-name",        "url": "https://domain.com/target/url",        "referer": "",        "ip": "1.2.3.0",        "country": "us",        "is_bot": false,        "browser": {          "name": "Chrome",          "version": "109.0"        },        "os": {          "name": "Mac",          "version": "10.15"        },        "device": "desktop",        "language": "en",        "tags": [
             "tag"
           ]      }    ],    "code": 0,    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
    Get TImeline Analytics [PRO]
    Return timeline analytics.
    Parameters
    From_Timestamp (Required): Datetime, indicating start datetime of analytics report. TO_Timestamp (Optional): Datetime, indicating end datetime of analytics report. Will default to current time. TinyURL (Optional): TinyURL to get analytics for.
    tag (Optional): Tag to get analytics for.

    interval (Optional)
    Set Timeline interval.
    Possible Values:
  • minute
  • hour
  • day
  • week
  • month
    • Response
    {  "body": {    "data": {      "dataset": [
           {
             "datetime": "2020-12-21 14:10:00",
             "total": 10020,
             "unique": 6000,
             "human": 9123
           }
         ],      "interval": "minute",      "timezone": "-08:00"    },    "code": 0,    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
    Get General Analytics [PRO]
    Return browser, os and device analytics.
    Parameters
    From_Timestamp (Required): Datetime, indicating start datetime of analytics report. TO_Timestamp (Optional): Datetime, indicating end datetime of analytics report. Will default to current time. TinyURL (Optional): TinyURL to get analytics for.
    tag (Optional): Tag to get analytics for.
    Response
    {  "body": {    "data": {      "dataset": [
           {
             "browser": {
               "name": "Chrome",
               "value": 0,
               "children": {
                 "name": "80",
                 "value": 0
               }
             },
             "os": {
               "name": "Windows",
               "value": 0,
               "children": {
                 "name": "10",
                 "value": 0
               }
             },
             "device": {
               "name": "Desktop",
               "value": 0
             }
           }
         ],      "total": 0    },    "code": 0,    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
    Get Top Sources Analytics [PRO]
    Return top sources analytics.
    Parameters
    From_Timestamp (Required): Datetime, indicating start datetime of analytics report. TO_Timestamp (Optional): Datetime, indicating end datetime of analytics report. Will default to current time. TinyURL (Optional): TinyURL to get analytics for.
    tag (Optional): Tag to get analytics for.
    Response
    {  "body": {    "data": {      "dataset": [
           {
             "source": "google.com",
             "hits": 23
           }
         ],      "direct": 12,      "total": 123    },    "code": 0,    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }
    Get Top Languages Analytics [PRO]
    Return top languages analytics.
    Parameters
    From_Timestamp (Required): Datetime, indicating start datetime of analytics report. TO_Timestamp (Optional): Datetime, indicating end datetime of analytics report. Will default to current time. TinyURL (Optional): TinyURL to get analytics for.
    tag (Optional): Tag to get analytics for.
    Response
    {  "body": {    "data": {      "dataset": [
           {
             "language": "en",
             "hits": 23
           }
         ],      "none": 12,      "total": 123    },    "code": 0,    "errors": [
         ""
       ]  },  "error": {    "status_code": 200,    "status_message": "OK",    "body": ""  },  "returned_an_error": false }