# Short Io

Short.io is a URL shortening service that allows users to create branded short links, manage them, and track their performance.

- **Category:** url shortener
- **Auth:** API_KEY
- **Tools:** 18
- **Triggers:** 0
- **Slug:** `SHORT_IO`
- **Version:** 20260211_00

## Tools

### Get Domain Link Clicks

**Slug:** `SHORT_IO_GET_DOMAINS_LINK_CLICKS`

Tool to get click statistics for specific links in a domain. Use when you need click counts for particular link IDs within a domain. Retrieves the number of clicks each specified link has received. Example: "Get click counts for links with IDs ['lnk_5YOn_turb6oFhe1NAosVTgOpq6', 'lnk_5YOn_WziFZJY3qcd1YDqVdRWg9'] in domain 1425403".

### Get Domain Paths

**Slug:** `SHORT_IO_GET_DOMAINS_PATHS`

Tool to list the most popular paths in a domain over time. Use after confirming a valid domain ID to analyze which short URL paths under that domain have received the most clicks in the given interval.

### Get Link Info by Link ID

**Slug:** `SHORT_IO_GET_LINK_INFO_BY_LINK_ID`

Retrieves comprehensive metadata for a short link using its unique ID. Returns original URL, short URL, domain, tags, click count, UTM parameters, timestamps, and more. Use this when you have a link ID and need its full details.

### Get Link Info by Path

**Slug:** `SHORT_IO_GET_LINK_INFO_BY_PATH`

Tool to get link info by its path and domain. Use when you need to look up a branded short link by its path within a specific domain.

### Get Link OpenGraph Properties

**Slug:** `SHORT_IO_GET_LINK_OPEN_GRAPH_PROPERTIES`

Tool to retrieve OpenGraph settings for a link. Use after creating or updating a link to verify its social metadata.

### Get Link Permissions

**Slug:** `SHORT_IO_GET_LINK_PERMISSIONS`

Retrieves all user access permissions for a specific short link within a domain. Use this to check which users have been granted access to view or manage a particular link. Returns an empty list if no special permissions have been configured. Example: "Show me who has access to link 'lnk_5YOn_lR5wxdiv88Qo9ZRF6akPi' in domain '1425403'".

### Get Link Regions by Country

**Slug:** `SHORT_IO_GET_LINK_REGION_LIST_COUNTRY`

Tool to list all regions available for a country. Use when targeting links by region within a specific country.

### Get Link Regions

**Slug:** `SHORT_IO_GET_LINK_REGIONS`

Retrieves all region-based targeting rules configured for a specific short link. Region targeting allows you to redirect users to different URLs based on their geographic region (e.g., California, Texas) within a country. This provides more granular control than country-level targeting. Returns an empty list if no region targeting rules are configured for the link.

### Get Links List

**Slug:** `SHORT_IO_GET_LINKS_LIST`

Tool to list short links on a domain with optional filters. Use after confirming the domain to retrieve or search links by criteria.

### Get Link Statistics

**Slug:** `SHORT_IO_GET_LINK_STATISTICS`

Tool to get click statistics for a specific link. Use when you need detailed click metrics over a specified interval.

### Get Link (Tweetbot)

**Slug:** `SHORT_IO_GET_LINK_TWEETBOT`

Create a short link using the simplified Tweetbot GET endpoint. This is a lightweight alternative to the standard POST link creation endpoint, designed for scenarios where GET requests are preferred (e.g., browser-based integrations, simple HTTP clients). Returns the shortened URL immediately upon success.

### Get Domain Statistics by Interval

**Slug:** `SHORT_IO_POST_DOMAINS_BY_INTERVAL`

Tool to retrieve domain statistics over a custom interval. Use when you need time-series click data for a specific domain over a defined time window.

### Post Domains Last Clicks

**Slug:** `SHORT_IO_POST_DOMAINS_LAST_CLICKS`

Tool to retrieve the latest raw click events for a domain. Use when detailed clickstream data is needed.

### Get Domain Top Values

**Slug:** `SHORT_IO_POST_DOMAINS_TOP`

Retrieves top values for a specified analytics column ranked by click count for a domain. Use to analyze which paths, countries, or other dimensions have the most traffic. Returns an ordered list of values with their click counts.

### Archive Links in Bulk

**Slug:** `SHORT_IO_POST_LINKS_ARCHIVE_BULK`

Archive multiple short links in a single API call (up to 150 links). Archived links are hidden from the dashboard but remain functional and accessible. Use this to organize or hide links without deleting them. Requires link IDs from previously created links.

### Create Links in Bulk

**Slug:** `SHORT_IO_POST_LINKS_BULK`

Tool to create up to 1000 short links in one call. Use when bulk shortening multiple URLs.

### Generate QR Codes in Bulk

**Slug:** `SHORT_IO_POST_LINKS_QR_BULK`

Tool to generate QR codes for multiple links in bulk. Use when you need to retrieve QR codes for several short links at once.

### Unarchive Links in Bulk

**Slug:** `SHORT_IO_POST_LINKS_UNARCHIVE_BULK`

Unarchive multiple short links in bulk (up to 150 links per request). This operation restores previously archived links to active status, making them functional and visible again. Use this when you need to restore visibility of a set of archived short links at once. The operation is idempotent - unarchiving already unarchived links succeeds without error.
