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.meresultsUnshortened 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-urlThe response will contain the unshortened URL corresponding to the provided short URL and success status.
This integration was tested with version 2 of the `unshorten.me` API. --- ## 🔑 Get an API Token 1. Navigate to the [`unshorten.me` API page](https://unshorten.me/api). 2. Follow the instructions to request a free API token, which typically involves filling out a request form. 3. Once you receive your token, copy it. You will need it to configure the integration instance in Cortex XSOAR. --- ## 📄 `unshorten.me` API Documentation [unshorten.me API](https://unshorten.me/api) --- ## Permissions A valid API Token is all that is required to use this integration. No other specific permissions or roles are needed.