Getting Started

Getting Started

Welcome to SocialKit! This guide will walk you through setting up and making your first API request. In just a few minutes, you’ll be able to analyze social media videos, extract summaries, and get transcripts using our API.

1. Get Your Access Key 🔑

To start using SocialKit, you’ll need an Access Token. Follow these steps:

  1. Sign up at SocialKit Dashboard
  2. Copy your Access Key from the project Access Keys tab.

You can attach your access key to requests in any of these ways:

  • GET parameter: access_key
  • POST parameter: access_key
  • Header: x-access-key

2. Make Your First API Request

Note: You can make requests using either GET or POST methods.

YouTube Video Summary

GET https://api.socialkit.dev/youtube/summarize?access_key=<your-access-key>&url=https://youtube.com/watch?v=dQw4w9WgXcQ

Response

{
	"success": true,
	"data": {
		"url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
		"summary": "The video features the song 'Never Gonna Give You Up' by Rick Astley, which expresses themes of love, commitment, and reassurance in a romantic relationship.",
		"mainTopics": ["Love", "Commitment", "Reassurance"],
		"keyPoints": [
			"The singer emphasizes unwavering commitment to a partner.",
			"The lyrics convey a sense of understanding and mutual feelings.",
			"The repetition of key phrases reinforces the message of loyalty."
		],
		"tone": "Uplifting and reassuring",
		"targetAudience": "Fans of 80s music and pop culture enthusiasts",
		"quotes": [
			"Never gonna give you up.",
			"Your heart's been aching but you're too shy to say it."
		],
		"timeline": "The song follows a structured verse-chorus format, alternating between expressions of commitment and emotional connection."
	}
}

TikTok Video Summary

GET https://api.socialkit.dev/tiktok/summarize?access_key=<your-access-key>&url=https://www.tiktok.com/@thepeteffect/video/7522711492140059912

Response

{
	"success": true,
	"data": {
		"url": "https://www.tiktok.com/@thepeteffect/video/7522711492140059912",
		"summary": "The video explains five reasons why cats might randomly attack their owners, including play aggression, overstimulation, redirected aggression, territorial behavior, and lack of socialization. It also provides tips on how to prevent these attacks by recognizing warning signs and respecting the cat's boundaries.",
		"mainTopics": ["Cat Behavior", "Pet Care", "Animal Psychology"],
		"keyPoints": [
			"Play aggression occurs when cats see hands or feet as prey targets.",
			"Overstimulation from excessive petting can trigger defensive responses.",
			"Redirected aggression happens when cats transfer frustration to nearby humans."
		],
		"tone": "Educational and informative",
		"targetAudience": "Cat owners and pet enthusiasts",
		"quotes": [
			"Ever been randomly attacked by your cat and thought, what did I do?",
			"Don't over pet and always respect their personal bubble."
		],
		"timeline": "The video systematically presents five reasons for cat aggression, followed by practical prevention tips and warning signs to watch for."
	}
}

YouTube Video Transcript

GET https://api.socialkit.dev/youtube/transcript?access_key=<your-access-key>&url=https://youtube.com/watch?v=dQw4w9WgXcQ

Response

{
	"success": true,
	"data": {
		"url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
		"transcript": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules\nand so do I ♪ ♪ A full commitment's\nwhat I'm thinking of ♪ ♪ You wouldn't get this\nfrom any other guy ♪ ♪ I just wanna tell you\nhow I'm feeling ♪ ♪ Gotta make you understand ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around\nand desert you ♪ ♪ Never gonna make you cry ♪ ♪ Never gonna say goodbye ♪ ♪ Never gonna tell a lie\nand hurt you ♪",
		"transcriptSegments": [
			{
				"text": "[♪♪♪]",
				"start": 0,
				"duration": 5,
				"timestamp": "00:00"
			},
			{
				"text": "♪ We're no strangers to love ♪",
				"start": 5,
				"duration": 5,
				"timestamp": "00:05"
			},
			{
				"text": "♪ You know the rules\nand so do I ♪",
				"start": 10,
				"duration": 5,
				"timestamp": "00:10"
			}
		],
		"wordCount": 458,
		"segments": 61
	}
}

TikTok Video Transcript

GET https://api.socialkit.dev/tiktok/transcript?access_key=<your-access-key>&url=https://www.tiktok.com/@thepeteffect/video/7522711492140059912

Response

{
	"success": true,
	"data": {
		"url": "https://www.tiktok.com/@thepeteffect/video/7522711492140059912",
		"transcript": "Ever been randomly attacked by your cat and thought, what did I do? Don't worry. There's usually a reason behind the chaos. 1, play aggression. Cats are born hunters and sometimes your hand, foot or even your face becomes the prey. 2, over stimulation. If you've been petting them a bit too long, especially on the belly, tail or sides, they might snap to say, that's enough, human. 3, redirected aggression. Like when your cat spots another feline outside, gets frustrated and decides you are now the enemy. 4, territorial vibes. Cats are super protective of their space and sometimes they throw paws to show who's boss. And 5, lack of socialization. If they weren't used to people early on, even a loving touch can feel like a threat. To avoid surprise attacks, learn the warning signs like twitchy tails or pinned ears. Use toys to redirect energy. Don't over pet and always respect their personal bubble.",
		"transcriptSegments": [
			{
				"text": "Ever been randomly attacked by your cat and thought,",
				"start": 0.04,
				"duration": 2.4,
				"timestamp": "00:00"
			},
			{
				"text": "what did I do? Don't worry.",
				"start": 2.441,
				"duration": 1.64,
				"timestamp": "00:02"
			},
			{
				"text": "There's usually a reason behind the chaos.",
				"start": 4.082,
				"duration": 1.899,
				"timestamp": "00:04"
			}
		],
		"wordCount": 157,
		"segments": 23
	}
}

YouTube Video Stats

GET https://api.socialkit.dev/youtube/stats?access_key=<your-access-key>&url=https://youtube.com/watch?v=dQw4w9WgXcQ

Response

{
	"success": true,
	"data": {
		"url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
		"title": "Rick Astley - Never Gonna Give You Up (Official Video)",
		"channelName": "Rick Astley",
		"channelLink": "https://youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
		"views": 1428567890,
		"likes": 16234567,
		"comments": 4567890
	}
}

YouTube Video Comments

GET https://api.socialkit.dev/youtube/comments?access_key=<your-access-key>&url=https://youtube.com/watch?v=dQw4w9WgXcQ&limit=2

Response

{
	"success": true,
	"data": {
		"url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
		"comments": [
			{
				"author": "@YouTube",
				"text": "can confirm: he never gave us up",
				"likes": 88,
				"date": "",
				"avatar": "https://yt3.ggpht.com/Bg5wS82KGryRmcsn1YbPThtbXoTmj2XJ9_7LmuE2RF6wbKJBkovfRypbSz6UD3gEu_nHiwGZtQ=s88-c-k-c0x00ffffff-no-rj",
				"replyCount": 1,
				"position": 1
			},
			{
				"author": "@IIIII911IIIII",
				"text": "But link sayd free robux",
				"likes": 0,
				"date": "",
				"avatar": "https://yt3.ggpht.com/ixP_4DyuJRryaowxiBKNKv_pvpbEyQHIQrHCZODkNBW-0Lk7eTYo_vL1iB3mL4TFgnV0PNVQiQ=s88-c-k-c0x00ffffff-no-rj",
				"replyCount": 738,
				"position": 2
			}
		]
	}
}

TikTok Video Stats

GET https://api.socialkit.dev/tiktok/stats?access_key=<your-access-key>&url=https://www.tiktok.com/@soukainasing1/video/7370790114802322694

Response

{
	"success": true,
	"data": {
		"url": "https://www.tiktok.com/@soukainasing1/video/7370790114802322694?q=coffee",
		"title": "#icedcoffee #dalgonacoffee #dalgona #soukainasing #coffeetiktok #bottlecoffee #icedlatte #easyrecipe #cafe #nescafe #nestle #coffee #refreshing #learnontiktok #قهوة_باردة #قهوة #foryoupage #fyp",
		"channelName": "thepeteffect",
		"channelLink": "https://www.tiktok.com/@thepeteffect",
		"likes": 2100000,
		"comments": 26000,
		"shares": 147600,
		"views": 70700000,
		"description": "#icedcoffee #dalgonacoffee #dalgona #soukainasing #coffeetiktok #bottlecoffee #icedlatte #easyrecipe #cafe #nescafe #nestle #coffee #refreshing #learnontiktok #قهوة_باردة #قهوة #foryoupage #fyp",
		"duration": "1:02",
		"thumbnailUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/2a1821f54d82fb691390afcccb773d78~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=051f7c8b&x-expires=1759514400&x-signature=IoW4IL0SRYOY83gQuyROCbF%2BQbw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5"
	}
}

TikTok Video Comments

GET https://api.socialkit.dev/tiktok/comments?access_key=<your-access-key>&url=https://www.tiktok.com/@xkikicat/video/7526606933470612744&limit=2

Response

{
	"success": true,
	"data": {
		"url": "https://www.tiktok.com/@xkikicat/video/7526606933470612744?q=cute%20cat&t=1759508362887",
		"comments": [
			{
				"author": "John",
				"text": "[sticker]",
				"likes": 28600,
				"date": "7-14",
				"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/43859730cad6a553023db23c3bea766f~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=5ec360b8&x-expires=1759593600&x-signature=PExId0varqKgdsZOJiu9BQ%2BCS%2Bo%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast8",
				"replyCount": 81,
				"username": "shahdoos"
			},
			{
				"author": "xanax",
				"text": "smol car [cry]",
				"likes": 10500,
				"date": "7-13",
				"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/aec029c88af7df57dbaf37ebade442b8~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=cb43e62c&x-expires=1759593600&x-signature=pYTZIciHW%2B3quorj6hlPx%2FahKow%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast8",
				"replyCount": 95,
				"username": "xanax_r6"
			}
		]
	}
}
IntroductionAuthentication