Short Io | Composio

Overview

Enum

SHORT_IO

Description

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

Authentication Details

API_KEY

api_key

stringRequired

Actions

SHORT_IO_GET_DOMAINS_LINK_CLICKS

Tool to get click statistics for all links in a domain. use when you need aggregated click counts for specific link ids within a branded domain. example: "get click counts for links ['id1','id2'] in domain '12345'".

Action Parameters

domainId

integerRequired

ids

arrayRequired

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

domainId

integerRequired

endDate

string

period

stringDefaults to last30

startDate

string

stringDefaults to UTC

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

domain_id

string

limit

integer

link_type

string

offset

integer

order

string

sort

string

tag

string

Action Response

data

object

error

string

successful

boolean

SHORT_IO_GET_LINK_INFO_BY_LINK_ID

Tool to get detailed info for a link by id. use when you need to retrieve all metadata for a specific short url after creation.

Action Parameters

domain_id

string

link_id

stringRequired

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

domain_id

stringRequired

path

stringRequired

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

domainId

integerRequired

linkId

stringRequired

Action Response

data

object

error

string

successful

boolean

SHORT_IO_GET_LINK_PERMISSIONS

Tool to list all user permissions for a link. use after confirming domain and link ids to fetch current access assignments. example: "list permissions for link 'abcde123' in domain '12345'".

Action Parameters

domain_id

stringRequired

link_id

stringRequired

Action Response

data

object

error

string

successful

boolean

SHORT_IO_GET_LINK_REGIONS

Tool to get region-based targeting rules for a link. use after fetching country-level rules to retrieve more granular region overrides.

Action Parameters

linkId

stringRequired

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

country

stringRequired

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

clicksChartInterval

string

endDate

string

linkId

stringRequired

period

stringDefaults to last30

skipTops

boolean

startDate

string

stringDefaults to UTC

Action Response

data

object

error

string

successful

boolean

SHORT_IO_GET_LINK_TWEETBOT

Tool to quickly create a link via query string (tweetbot). use when you cannot use the post create-link endpoint and need a simple get workaround.

Action Parameters

domain

stringRequired

originalURL

stringRequired

path

string

title

string

urlOnly

boolean

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

domainId

integerRequired

endDate

string

period

stringDefaults to last30

startDate

string

stringDefaults to UTC

Action Response

data

object

error

string

successful

boolean

SHORT_IO_POST_DOMAINS_LAST_CLICKS

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

Action Parameters

afterDate

string

beforeDate

string

domainId

integerRequired

endDate

string

exclude

object

include

object

limit

integerDefaults to 30

period

stringDefaults to last30

startDate

string

stringDefaults to UTC

Action Response

data

object

error

string

successful

boolean

SHORT_IO_POST_DOMAINS_TOP

Tool to retrieve top values of a specified column by click count. use after confirming domain id and choosing a column.

Action Parameters

column

stringRequired

domainId

integerRequired

limit

integerDefaults to 10

Action Response

data

object

error

string

successful

boolean

SHORT_IO_POST_LINKS_ARCHIVE_BULK

Tool to archive multiple links in one call. use when you need to deactivate or hide a set of short links at once.

Action Parameters

linkIds

arrayRequired

Action Response

data

object

error

string

successful

boolean

SHORT_IO_POST_LINKS_BULK

Tool to create up to 1000 short links in one call. use when bulk shortening multiple urls.

Action Parameters

allowDuplicates

boolean

domain

stringRequired

links

arrayRequired

Action Response

data

object

error

string

successful

boolean

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.

Action Parameters

backgroundColor

string

color

string

domainId

string

linkIds

arrayRequired

noExcavate

boolean

size

integer

type

stringDefaults to png

useDomainSettings

booleanDefaults to True

Action Response

data

object

error

string

successful

boolean

SHORT_IO_POST_LINKS_UNARCHIVE_BULK

Tool to unarchive multiple links in bulk. use when you need to restore visibility of a set of previously archived short links at once.

Action Parameters

linkIds

arrayRequired

Action Response

data

object

error

string

successful

boolean