Skip to content

Integrations

Raycast extension

Shorten links and check their clicks from Raycast on macOS and Windows. Install the iShortn extension, add an API key and use its three commands.

The iShortn extension for Raycast shortens the URL you've selected or copied, and shows how a short link is doing, without opening the dashboard. It uses the iShortn API, so it needs an API key, and API keys need a Pro or Ultra plan.

Install

  1. Open Raycast and run the Store command.
  2. Search for iShortn and choose Install Extension.
  3. Run any iShortn command. Raycast asks for your API key the first time.

Add your API key

  1. Open Settings in the dashboard and scroll to API Keys.
  2. Click Create API Key and copy the key from the dialog. It's shown once.
  3. Paste it into the API Key field Raycast shows, or later in Raycast's Settings → Extensions → iShortn.

The key works in your personal workspace: links you create from Raycast are added there, and Link Analytics only finds links in it. See Which links the API can reach.

PreferenceRequiredDescription
API KeyYesThe key from Settings.
Default DomainNoThe domain for new links, and for Link Analytics when you enter only an alias. A platform domain such as isht.ink or an active custom domain. Leave it empty to use the default domain from Settings → General, or isht.app.

Commands

CommandWhat it does
Shorten LinkA form with the URL, an optional alias and an optional domain. The URL is filled in from the text you've selected, or from the clipboard, when it's an http:// or https:// link. The short link is copied to your clipboard, and the confirmation offers Open in Browser and Copy.
Shorten Clipboard URLShortens the URL on your clipboard straight away, with a random alias and your default domain, and replaces the clipboard with the short link. Give it a hotkey to shorten a copied link in one keystroke.
Link AnalyticsEnter an alias such as launch-day, or paste a short link such as https://isht.app/launch-day. Shows total clicks and the top countries, devices and referrers, with an action to open the link's analytics in the dashboard.

Link Analytics covers the same date range as the dashboard for your plan. Links you shorten from Raycast count toward your monthly link limit, like links created in the dashboard. See Plans and limits.

Errors

MessageWhat to do
Invalid API keyThe key was mistyped or deleted. Create a new one in Settings and paste it into the extension preferences, which the error's action opens.
API access needs a Pro or Ultra planThe key's account isn't on a paid plan. The error's action opens Pricing. See API access by plan.
Rate limit reachedToo many requests in a short time. The message says when to try again. See Rate limits.
No URL in clipboardShorten Clipboard URL only takes a single link that starts with http:// or https://.

Other errors, such as an alias that's already taken or a domain that isn't available to your key, show the API's message. See Responses and errors.

Something missing or unclear? Email support@ishortn.ink.