Linkish is a versatile API that enhances the way you handle web links. It allows you to organize, preview, and optimize web links with features such as URL shortening, web page metadata retrieval, and link previews with screenshots. With Pipedream, you can create powerful automations by connecting Linkish to other services to streamline content sharing, web research, and digital marketing workflows.
module.exports = defineComponent({
props: {
linkish: {
type: "app",
app: "linkish",
}
},
async run({steps, $}) {
const axios = require('axios');
let access_token = "";
// Card details
let type = "link", // either "link" or "text"
url = "https://www.youtube.com/watch?v=dQw4w9WgXcQ", // required if "type" is "link"
title = "", // card title, if empty it will be scraped from "url"
description = "", // card description, if empty it will be scraped from "url"
thumbnail = "", // preview image URL, if empty it will be scraped from "url"
parent = "", // collections[index].id recieved from get-collection API
tags = []; // an array of strings, items can also have comma separated strings
// Get access token based on the linkish API key
return await axios({
method : "POST",
url: "https://api.linkish.io/get-token",
data : JSON.stringify({
"api_key": this.linkish.$auth.api_key
}),
headers: {
"Content-Type": "application/json",
"Accept": "application/json",
}
}).then(async (response) => {
// Get collections based on the access token
access_token = response.data.token;
return await axios({
method : "GET",
url: "https://api.linkish.io/get-collections",
headers: {
"Authorization": `Bearer ${access_token}`,
}
})
}).then((response) => {
// Return the data as the step export
return response.data;
}).then(async (collections) => {
// Change parent collection ID here or keep it empty for adding links to root collection
parent = collections[0].id;
// Save link in linkish dashboard
return await axios({
method : "POST",
url: "https://api.linkish.io/save-link",
data : JSON.stringify({
"type": type,
"url": url,
"title": title,
"desc": description,
"thumbnail": thumbnail,
"parent": parent,
"tags": tags,
}),
headers: {
"Authorization": `Bearer ${access_token}`,
"Content-Type": "application/json",
"Accept": "application/json",
}
})
}).then((response) => {
// Return the data as the step export
return response.data
})
},
})
Content Sharing Automation: Trigger a Pipedream workflow whenever you publish a new blog post or article. Use Linkish to shorten the URL and fetch metadata, then automatically distribute the link with a preview and description to multiple social media platforms using apps like Twitter, Facebook, and LinkedIn.
Digital Marketing Campaign Tracking: Set up a workflow that creates shortened links with Linkish for different marketing campaigns. Integrate with Google Sheets to log each unique link along with campaign details. Use Pipedream to track link clicks by connecting to analytics services and update the corresponding Google Sheets rows with real-time performance data.
Research & Data Collection: Organize a workflow where, upon adding a new URL to a designated project management tool like Trello or Asana, Pipedream triggers Linkish to retrieve the metadata and screenshot of the page. Store the collected data in a centralized database or spreadsheet for a visual and structured research library.
Linkish uses API keys for authentication. When you connect your Linkish account, Pipedream securely stores the keys so you can easily authenticate to Linkish APIs in both code and no-code steps.
Get your API key (or generate a new one) from https://linkish.io/settings.