NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

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 ShortenerAnalyticsWeb del proveedor
Acciones
18
Triggers
0
Autenticación
—
OAuth gestionado
No
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