Short Io

short_io

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

URL Shortener Analytics Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (18)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Get Domain Link ClicksSHORT_IO_GET_DOMAINS_LINK_CLICKSAcción

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'".

Parámetros de entrada

idsstring[]Obligatorio
List of link IDs to get click counts for.
domainIdintegerObligatorio
Identifier of the domain to retrieve link click statistics for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Domain PathsSHORT_IO_GET_DOMAINS_PATHSAcción

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.

Parámetros de entrada

tzstring
Timezone name for date boundaries (e.g., 'UTC', 'America/New_York').
periodstringenum
Time interval for which to retrieve the most popular paths. Use 'custom' to supply startDate and endDate.
customtodayyesterdaytotalweekmonthlastmonthlast7last30
endDatestringdate
End date (YYYY-MM-DD) for custom period; required if period is 'custom'.
domainIdintegerObligatorio
Identifier of the domain whose path statistics will be retrieved.
startDatestringdate
Start date (YYYY-MM-DD) for custom period; required if period is 'custom'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link Info by Link IDSHORT_IO_GET_LINK_INFO_BY_LINK_IDAcción

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.

Parámetros de entrada

link_idstringObligatorio
The unique identifier of the short link.
domain_idstring
Optional custom domain ID to apply (if using multiple domains).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link Info by PathSHORT_IO_GET_LINK_INFO_BY_PATHAcción

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.

Parámetros de entrada

pathstringObligatorio
Short link path segment (the part after the domain) to look up.
domain_idstringObligatorio
Identifier of the domain under which the short link resides.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link OpenGraph PropertiesSHORT_IO_GET_LINK_OPEN_GRAPH_PROPERTIESAcción

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

Parámetros de entrada

linkIdstringObligatorio
The unique identifier of the short link to retrieve OpenGraph properties for.
domainIdintegerObligatorio
Identifier of the branded domain where the link is hosted.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link PermissionsSHORT_IO_GET_LINK_PERMISSIONSAcción

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'".

Parámetros de entrada

link_idstringObligatorio
ID of the short link to list permissions for
domain_idstringObligatorio
ID of the domain the link belongs to

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link Regions by CountrySHORT_IO_GET_LINK_REGION_LIST_COUNTRYAcción

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

Parámetros de entrada

countrystringObligatorio
Country code in ISO 3166-1 alpha-2 format

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link RegionsSHORT_IO_GET_LINK_REGIONSAcción

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

Parámetros de entrada

linkIdstringObligatorio
Unique identifier of the link to fetch region-targeting rules for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Links ListSHORT_IO_GET_LINKS_LISTAcción

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

Parámetros de entrada

tagstring
Filter links by a specific tag
sortstringenum
Field to sort by: 'created_at' or 'clicks'
created_atclicks
limitinteger
Maximum number of links to return (1-100, default 50)
orderstringenum
Sorting order: 'asc' or 'desc'
ascdesc
offsetinteger
Number of links to skip for pagination
searchstring
Search by original or short URL substring
domain_idstring
ID of the domain to list links from
link_typestringenum
Filter by link type: 'short' or 'cloaked'
shortcloaked

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link StatisticsSHORT_IO_GET_LINK_STATISTICSAcción

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

Parámetros de entrada

tzstring
IANA timezone for grouping; defaults to UTC.
linkIdstringObligatorio
Unique identifier of the short link.
periodstringenum
Time interval for statistics; defaults to last30. Use 'custom' for custom dates.
customtodayyesterdaytotalweekmonthlastmonthlast7last30
endDatestringdate
End date for custom interval (YYYY-MM-DD); required if period is 'custom'.
skipTopsboolean
Whether to skip top referrer records; defaults to false.
startDatestringdate
Start date for custom interval (YYYY-MM-DD); required if period is 'custom'.
clicksChartIntervalstringenum
Granularity for click statistics chart; one of hour, day, week, month.
hourdayweekmonth

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Link (Tweetbot)SHORT_IO_GET_LINK_TWEETBOTAcción

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.

Parámetros de entrada

pathstring
Custom path for the short link (optional).
titlestring
Title metadata for the link (optional).
domainstringObligatorio
Domain hostname to create the short link on.
urlOnlyboolean
If true, returns only the URL string instead of full payload.
originalURLstringObligatorio
Original URL to shorten.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Domain Statistics by IntervalSHORT_IO_POST_DOMAINS_BY_INTERVALAcción

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.

Parámetros de entrada

tzstring
IANA timezone name for interval boundaries; defaults to 'UTC'.
periodstringenum
Time interval for statistics. Defaults to 'last30'. Use 'custom' to specify a start and end date.
customtodayyesterdaytotalweekmonthlastmonthlast7last30
endDatestringdate
End date (YYYY-MM-DD) for custom interval; required if period is 'custom'.
domainIdintegerObligatorio
Identifier of the domain to fetch statistics for.
startDatestringdate
Start date (YYYY-MM-DD) for custom interval; required if period is 'custom'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Post Domains Last ClicksSHORT_IO_POST_DOMAINS_LAST_CLICKSAcción

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

Parámetros de entrada

tzstring
IANA timezone for grouping; defaults to UTC.
limitinteger
Maximum number of click events to retrieve; defaults to 30.
periodstringenum
Preset time interval; use 'custom' with startDate and endDate.
customtodayyesterdaytotalweekmonthlastmonthlast7last30
endDatestringdate
End date for 'custom' period (YYYY-MM-DD).
excludeobject
Filters to exclude specific click events.
includeobject
Filters to include specific click events.
domainIdintegerObligatorio
Identifier of the domain to fetch click events for.
afterDatestringdate
Pagination: return events after this date.
startDatestringdate
Start date for 'custom' period (YYYY-MM-DD).
beforeDatestringdate
Pagination: return events before this date.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Domain Top ValuesSHORT_IO_POST_DOMAINS_TOPAcción

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

Parámetros de entrada

limitinteger
Maximum number of top values to return; must be at least 1.
columnstringObligatorio
Name of the column to rank by click count (e.g., 'path', 'country', 'device').
domainIdintegerObligatorio
Identifier of the domain for which to retrieve top column values.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Archive Links in BulkSHORT_IO_POST_LINKS_ARCHIVE_BULKAcción

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

Parámetros de entrada

linkIdsstring[]Obligatorio
List of short link IDs to archive in bulk.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Links in BulkSHORT_IO_POST_LINKS_BULKAcción

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

Parámetros de entrada

linksobject[]Obligatorio
List of link objects to be shortened (up to 1000 items).
domainstringObligatorio
Domain under which the short links will be created.
allowDuplicatesboolean
Whether duplicate links are allowed (defaults to false).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate QR Codes in BulkSHORT_IO_POST_LINKS_QR_BULKAcción

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

Parámetros de entrada

sizeinteger
Size of the QR code (1-99).
typestringenum
Image format for QR codes. Defaults to 'png'.
pngsvg
colorstring
Foreground color for QR code (hex code or RGB).
linkIdsstring[]Obligatorio
List of up to 150 link IDs to generate QR codes for.
domainIdstring
Optional domain ID to override default domain settings.
noExcavateboolean
If true, disables the 'eye' excavation in the QR code.
backgroundColorstring
Background color for QR code (hex code or RGB).
useDomainSettingsboolean
Whether to apply domain-level QR settings. Defaults to true.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Unarchive Links in BulkSHORT_IO_POST_LINKS_UNARCHIVE_BULKAcción

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

Parámetros de entrada

linkIdsstring[]Obligatorio
List of short link IDs to unarchive

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not