unshortenMe

Unshorten.me is a free service to Un-Shorten the URLs created by URL shortening services. Unshorten.me can un-shorten URLs created by different services like goo.gl (Google), fb.me (Facebook), t.co (Twitter), bit.ly, TinyURL, ow.ly among others.

Utilities · UnshortenMe

Details

ID	`unshortenMe`
Provider	Open Source
Category	Utilities
From Version	6.10.0
Docker Image	`demisto/python3:3.12.13.10116658`

README

`unshorten.me` Integration (Community)

Overview

This integration allows you to unshorten URLs using the unshorten.me service. It is useful for revealing the final destination of shortened links from services like bit.ly, t.co (Twitter), TinyURL, and more, which is a common requirement in threat analysis and phishing investigations.

To use this integration, you must request a free API token from unshorten.me.

Configure `unshorten.me` on Cortex XSOAR

Navigate to Settings > Integrations > Servers & Services.
Search for unshorten.me.
Click Add instance to create and configure a new integration instance.

Parameter	Description	Required
API Token	The API token for your `unshorten.me` account.	True
Trust any certificate (not secure)	When selected, the integration ignores TLS/SSL certificate validation errors. Use with caution.	False
Use system proxy settings	When selected, the integration uses the system’s proxy settings.	False

Click Test to validate the URL and token.

Commands

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

1. unshorten-me-unshorten-url

Unshortens a given URL.

Base Command

unshorten-me-unshorten-url

Input

Argument Name	Description	Required
shortUrl	The shortened URL to expand. e.g., `https://bit.ly/3DKWm5t`	True

Context Output

Path	Type	Description
unshortenMe.unshortened_url	String	The full, original destination URL.
unshortenMe.shortened_url	String	The shortened URL that was provided as input.
unshortenMe.success	Boolean	`True` if the operation was successful, otherwise `False`.

Command Example

!unshorten-me-unshorten-url shortUrl="https://bit.ly/3DKWm5t"

Human Readable Output

unshorten.me results

Unshortened URL: https://www.youtube.com/
Shortened URL: https://bit.ly/3DKWm5t
Success: True

Context Example

```json
{
“unshortenMe”: {
“success”: true,
“shortened_url”: “https://bit.ly/3DKWm5t”,
“unshortened_url”: “https://www.youtube.com/”
}
}

Configuration parameters

credentials — (required)

Commands (1)

unshorten-me-unshorten-url
The response will contain the unshortened URL corresponding to the provided short URL and success status.

Source

unshortenMe.py unshortenMe_test.py unshortenMe.yml unshortenMe_description.md

Download History Raw

category: Utilities
provider: Open Source
commonfields:
  id: unshortenMe
  version: -1
configuration:
- additionalinfo: The token assigned to your unshortenMe profile.
  section: Connect
  displaypassword: Token
  name: credentials
  required: true
  hiddenusername: true
  type: 9
description: Unshorten.me is a free service to Un-Shorten the URLs created by URL shortening services. Unshorten.me can un-shorten URLs created by different services like goo.gl (Google), fb.me (Facebook), t.co (Twitter), bit.ly, TinyURL, ow.ly among others.
display: unshortenMe
name: unshortenMe
script:
  commands:
  - arguments:
    - description: The shortened URL.
      name: shortUrl
      required: true
    description: The response will contain the unshortened URL corresponding to the provided short URL and success status.
    name: unshorten-me-unshorten-url
    outputs:
    - contextPath: unshortenMe.unshortened_url
      description: The original URL.
      type: string
    - contextPath: unshortenMe.shortened_url
      description: The shortened URL.
      type: string
    - contextPath: unshortenMe.success
      description: The status of the unshorten operation.
      type: boolean
  dockerimage: demisto/python3:3.12.13.10116658
  runonce: false
  script: ''
  subtype: python3
  type: python
tests:
- unshortenMe Test
sectionorder:
- Connect
fromversion: 6.10.0