### YouTube Comments API GET Request Example Source: https://docs.socialkit.dev/api-reference/youtube-comments-api Example GET request to the YouTube Comments API. This demonstrates how to specify the video URL, access key, and sorting preferences. ```HTTP GET https://api.socialkit.dev/youtube/comments?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ&limit=2&sortBy=top ``` -------------------------------- ### YouTube Summary API Request Example Source: https://docs.socialkit.dev/api-reference/youtube-summarize-api This example demonstrates how to make a GET request to the YouTube Summary API to analyze a YouTube video. It requires an access key and the YouTube video URL. ```http GET https://api.socialkit.dev/youtube/summarize?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ ``` -------------------------------- ### Get YouTube Transcript (HTTP Request Example) Source: https://docs.socialkit.dev/api-reference/youtube-transcript-api This example demonstrates how to make a GET request to the YouTube Transcript API to fetch a video's transcript. It includes the necessary parameters such as the access key and the YouTube video URL. ```http GET https://api.socialkit.dev/youtube/transcript?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ ``` -------------------------------- ### Get TikTok Transcript - Example Request Source: https://docs.socialkit.dev/api-reference/tiktok-transcript-api Demonstrates how to fetch a transcript from a TikTok video using the API. This example uses a GET request with required parameters like access key and video URL. ```http GET https://api.socialkit.dev/tiktok/transcript?access_key=&url=https://www.tiktok.com/@thepeteffect/video/7522711492140059912 ``` -------------------------------- ### Example GET Request for YouTube Stats API Source: https://docs.socialkit.dev/api-reference/youtube-stats-api This example demonstrates how to make a GET request to the YouTube Stats API to retrieve video statistics. It requires an access key and the YouTube video URL. The response includes engagement metrics and video metadata. ```http GET https://api.socialkit.dev/youtube/stats?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ ``` -------------------------------- ### Example TikTok Summary API Request Source: https://docs.socialkit.dev/api-reference/tiktok-summarize-api This example demonstrates how to make a GET request to the TikTok Summary API to analyze a specific TikTok video. It includes the required access key and the TikTok video URL. ```http GET https://api.socialkit.dev/tiktok/summarize?access_key=&url=https://www.tiktok.com/@thepeteffect/video/7522711492140059912 ``` -------------------------------- ### YouTube Summary API Response Example Source: https://docs.socialkit.dev/api-reference/youtube-summarize-api This is an example of a successful response from the YouTube Summary API. It includes the original URL, a summary, main topics, key points, tone, target audience, quotes, and timeline of the video. ```json { "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." } } ``` -------------------------------- ### Get TikTok Video Stats (Example Request) Source: https://docs.socialkit.dev/api-reference/tiktok-stats-api This example demonstrates how to make a GET request to the TikTok Stats API to retrieve engagement metrics for a specific TikTok video. It requires an access key and the TikTok video URL as parameters. ```HTTP GET https://api.socialkit.dev/tiktok/stats?access_key=&url=https://www.tiktok.com/@soukainasing1/video/7370790114802322694 ``` -------------------------------- ### YouTube Comments API Response Example Source: https://docs.socialkit.dev/api-reference/youtube-comments-api Example JSON response from the YouTube Comments API. This shows the structure of the returned data, including comment details like author, text, likes, and reply count. ```JSON { "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": 375, "date": "", "avatar": "https://yt3.ggpht.com/ixP_4DyuJRryaowxiBKNKv_pvpbEyQHIQrHCZODkNBW-0Lk7eTYo_vL1iB3mL4TFgnV0PNVQiQ=s88-c-k-c0x00ffffff-no-rj", "replyCount": 738, "position": 2 } ] } } ``` -------------------------------- ### Custom Response Parameter Example Source: https://docs.socialkit.dev/api-reference/youtube-summarize-api This example shows how to use the `custom_response` parameter to define specific fields for the AI's analysis, such as video title, sentiment, category, and language. ```json { "title": "Video title", "sentiment": "Overall sentiment of the video", "isMusic": "Whether the video is a music video", "category": "Video category or genre", "language": "Primary language spoken in the video" } ``` -------------------------------- ### Example TikTok Summary API Response Source: https://docs.socialkit.dev/api-reference/tiktok-summarize-api This is an example of a successful response from the TikTok Summary API. It includes the original video URL, an AI-generated summary, main topics, key points, tone, target audience, quotes, and a timeline analysis of the video content. ```json { "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.", "Territorial behavior drives cats to assert dominance in their space.", "Poor early socialization makes cats perceive human touch as threatening." ], "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." } } ``` -------------------------------- ### Fetch TikTok Comments - HTTP Request Source: https://docs.socialkit.dev/api-reference/tiktok-comments-api This example demonstrates how to make an HTTP GET request to the TikTok Comments API to retrieve comments from a specific TikTok video. It requires an access key and the TikTok video URL, with an optional limit for the number of comments returned. ```HTTP GET https://api.socialkit.dev/tiktok/comments?access_key=&url=https://www.tiktok.com/@xkikicat/video/7526606933470612744&limit=2 ``` -------------------------------- ### Authentication Methods Source: https://docs.socialkit.dev/authentication Learn how to authenticate your API requests using your access key. Access keys can be provided via GET parameters, POST parameters, or a custom header. ```APIDOC ## Authentication ### Description To interact with our API, you'll authenticate requests using your access key. Manage your Access Key securely in your project Access Keys page. Your Access Key grants significant privileges, so it's crucial to keep it confidential. Avoid sharing your Access Key in public repositories, client-side code, or any publicly accessible areas. ### Method Any (GET, POST, etc.) ### Endpoint Any ### Parameters #### Query Parameters - **access_key** (string) - Required - Your unique access key for authentication. #### Request Body - **access_key** (string) - Required - Your unique access key for authentication. #### Headers - **x-access-key** (string) - Required - Your unique access key for authentication. ### Request Example (Query Parameter) ``` GET /api/data?access_key=YOUR_ACCESS_KEY ``` ### Request Example (POST Parameter) ``` POST /api/resource Content-Type: application/x-www-form-urlencoded access_key=YOUR_ACCESS_KEY&other_param=value ``` ### Request Example (Header) ``` GET /api/data x-access-key: YOUR_ACCESS_KEY ``` ### Important Security Reminders - **Security First:** Your Access Key is sensitive information, treat it as such. - **Authentication is Mandatory:** API requests without authentication will fail. ``` -------------------------------- ### Custom Response Parameter Example Source: https://docs.socialkit.dev/api-reference/tiktok-summarize-api This example shows how to use the `custom_response` parameter to define specific fields you want to extract from the AI's analysis. You can specify fields like title, sentiment, educational status, category, and language. ```json { "title": "Video title", "sentiment": "Overall sentiment of the video", "isEducational": "Whether the video is educational content", "category": "Video category or genre", "language": "Primary language spoken in the video" } ``` -------------------------------- ### Example Response from YouTube Stats API Source: https://docs.socialkit.dev/api-reference/youtube-stats-api This is a sample JSON response from the YouTube Stats API, detailing successful retrieval of video statistics. It includes the video URL, title, channel information, and engagement metrics like views, likes, and comments. ```json { "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 } } ``` -------------------------------- ### GET /tiktok/summarize Source: https://docs.socialkit.dev/api-reference/tiktok-summarize-api Analyzes a TikTok video to generate a summary, extract main topics, key points, and other insights. Requires an access key and the TikTok video URL. ```APIDOC ## GET /tiktok/summarize ### Description Analyzes a TikTok video to generate a summary, extract main topics, key points, and other insights. Requires an access key and the TikTok video URL. ### Method GET ### Endpoint https://api.socialkit.dev/tiktok/summarize ### Parameters #### Query Parameters - **url** (string) - Required - The TikTok URL of the video to analyze. Supports various TikTok URL formats. - **access_key** (string) - Required - Your API access key. Can be provided via the `access_key` query parameter, `x-access-key` header, or request body. - **custom_response** (object | string) - Optional - Define custom fields for the AI response. This allows you to extract specific information tailored to your needs. - **custom_prompt** (string) - Optional - Add your own instructions to guide the AI’s analysis. For example: “Make it short and concise”, “Write in Spanish”, “Focus on technical aspects”, etc. - **cache** (boolean) - Optional - Defaults to false. Cache the response for faster subsequent requests. - **cache_ttl** (number) - Optional - Defaults to 2592000. Cache the response for a custom TTL (in seconds). Maximum `2592000` seconds (1 month), minimum `3600` seconds (1 hour). ### Request Example ``` GET https://api.socialkit.dev/tiktok/summarize?access_key=&url=https://www.tiktok.com/@thepeteffect/video/7522711492140059912 ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the analysis results. - **url** (string) - The URL of the analyzed TikTok video. - **summary** (string) - An AI-generated summary of the video content. - **mainTopics** (array of strings) - The main topics discussed in the video. - **keyPoints** (array of strings) - A list of key points or takeaways from the video. - **tone** (string) - The overall tone of the video (e.g., "Educational and informative"). - **targetAudience** (string) - The intended audience for the video. - **quotes** (array of strings) - Notable quotes from the video. - **timeline** (string) - A description of the video's structure or progression. #### Response Example ```json { "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.", "Territorial behavior drives cats to assert dominance in their space.", "Poor early socialization makes cats perceive human touch as threatening." ], "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." } } ``` ``` -------------------------------- ### GET /youtube/transcript Source: https://docs.socialkit.dev/api-reference/youtube-transcript-api Fetches the transcript of a given YouTube video. It can return the full text transcript or detailed timestamped segments. ```APIDOC ## GET /youtube/transcript ### Description Fetches the transcript of a given YouTube video. It can return the full text transcript or detailed timestamped segments. ### Method GET ### Endpoint https://api.socialkit.dev/youtube/transcript ### Parameters #### Query Parameters - **url** (string) - Required - The YouTube URL of the video to extract transcript from. Supports various YouTube URL formats. - **access_key** (string) - Required - Your API access key. - **cache** (boolean) - Optional - Defaults to false. Cache the response for faster subsequent requests. - **cache_ttl** (number) - Optional - Defaults to 2592000. Cache the response for a custom TTL in seconds. Maximum 2592000 seconds (1 month), minimum 3600 seconds (1 hour). ### Request Example ```json GET https://api.socialkit.dev/youtube/transcript?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the transcript information. - **url** (string) - The YouTube URL processed. - **transcript** (string) - The complete text transcript of the video. - **transcriptSegments** (array) - An array of objects, each representing a timestamped segment of the transcript. - **text** (string) - The spoken text for this segment. - **start** (number) - Start time in seconds. - **duration** (number) - Duration of the segment in seconds. - **timestamp** (string) - Human-readable timestamp (MM:SS format). - **wordCount** (number) - Total number of words in the transcript. - **segments** (number) - Total number of transcript segments. #### Response Example ```json { "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 ♪ ...", "transcriptSegments": [ { "text": "[♪♪♪]", "start": 0, "duration": 5, "timestamp": "00:00" }, { "text": "♪ We're no strangers to love ♪", "start": 5, "duration": 5, "timestamp": "00:05" } ], "wordCount": 458, "segments": 61 } } ``` ``` -------------------------------- ### GET /youtube/comments Source: https://docs.socialkit.dev/api-reference/youtube-comments-api Retrieves comments from a specified YouTube video. ```APIDOC ## GET /youtube/comments ### Description This endpoint retrieves comments from a YouTube video. You can filter and sort the comments based on various criteria. ### Method GET ### Endpoint https://api.socialkit.dev/youtube/comments ### Parameters #### Query Parameters - **url** (string) - Required - The YouTube URL of the video to get comments for. Supports various YouTube URL formats. - **access_key** (string) - Required - Your API access key. Can be provided via the `access_key` query parameter, `x-access-key` header, or request body. - **limit** (number) - Optional - Defaults to 10. The number of comments to retrieve. Maximum value is 100. - **sortBy** (string) - Optional - Defaults to ‘new’. Sort comments by ‘top’ (most popular) or ‘new’ (most recent). ### Request Example ```json { "code": "GET https://api.socialkit.dev/youtube/comments?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ&limit=2&sortBy=top" } ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the video comments data. - **url** (string) - The YouTube URL of the video. - **comments** (array) - An array of comment objects. - **author** (string) - The comment author’s username (with @ prefix). - **text** (string) - The comment text content. - **likes** (number) - Number of likes on the comment. - **date** (string) - Comment date (may be empty). - **avatar** (string) - URL to the author’s profile picture. - **replyCount** (number) - Number of replies to this comment. - **position** (number) - Comment position in the sorted list. #### Response Example ```json { "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": 375, "date": "", "avatar": "https://yt3.ggpht.com/ixP_4DyuJRryaowxiBKNKv_pvpbEyQHIQrHCZODkNBW-0Lk7eTYo_vL1iB3mL4TFgnV0PNVQiQ=s88-c-k-c0x00ffffff-no-rj", "replyCount": 738, "position": 2 } ] } } ``` ### Use Cases - **Community Management**: Monitor and analyze video comments for engagement insights. - **Sentiment Analysis**: Analyze comment sentiment to understand audience reactions. - **Content Moderation**: Review comments for inappropriate content or spam. - **Market Research**: Gather user feedback and opinions from video comments. - **Competitor Analysis**: Analyze competitor video engagement through comments. - **Social Listening**: Track mentions and discussions around your content. - **Content Strategy**: Understand what resonates with your audience based on comment feedback. ### Notes - Comments are retrieved in real-time from YouTube. - Avatar URLs may be empty for some users. - Reply counts include nested replies and may change over time. - The `position` field indicates the comment’s order in the sorted results. Last updated on August 16, 2025 ``` -------------------------------- ### GET /youtube/stats Source: https://docs.socialkit.dev/api-reference/youtube-stats-api Retrieves engagement metrics and metadata for a given YouTube video URL. ```APIDOC ## GET /youtube/stats ### Description Retrieves engagement metrics and metadata for a given YouTube video URL. ### Method GET ### Endpoint https://api.socialkit.dev/youtube/stats ### Parameters #### Query Parameters - **url** (string) - Required - The YouTube URL of the video to get statistics for. Supports various YouTube URL formats. - **access_key** (string) - Required - Your API access key. Can be provided via the `access_key` query parameter, `x-access-key` header, or request body. - **cache** (boolean) - Optional - Defaults to false. Cache the response for faster subsequent requests. - **cache_ttl** (number) - Optional - Defaults to 2592000. Cache the response for a custom TTL (in seconds). Maximum `2592000` seconds (1 month), minimum `3600` seconds (1 hour). ### Request Example ```json { "example": "GET https://api.socialkit.dev/youtube/stats?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ" } ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the video statistics. - **url** (string) - The original YouTube URL provided. - **title** (string) - The video title. - **channelName** (string) - The name of the YouTube channel. - **channelLink** (string) - Direct link to the YouTube channel. - **views** (number) - Total view count. - **likes** (number) - Total like count. - **comments** (number) - Total comment count. #### Response Example ```json { "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 } } ``` ``` -------------------------------- ### GET /tiktok/stats Source: https://docs.socialkit.dev/api-reference/tiktok-stats-api Retrieves engagement metrics and metadata for a given TikTok video URL. ```APIDOC ## GET /tiktok/stats ### Description Retrieves engagement metrics and metadata for a given TikTok video URL. ### Method GET ### Endpoint https://api.socialkit.dev/tiktok/stats ### Parameters #### Query Parameters - **url** (string) - Required - The TikTok URL of the video to get statistics for. Supports various TikTok URL formats. - **access_key** (string) - Required - Your API access key. - **cache** (boolean) - Optional - Defaults to false. Cache the response for faster subsequent requests. - **cache_ttl** (number) - Optional - Defaults to 2592000. Cache the response for a custom TTL (in seconds). Maximum 2592000 seconds (1 month), minimum 3600 seconds (1 hour). ### Request Example ```json GET https://api.socialkit.dev/tiktok/stats?access_key=&url=https://www.tiktok.com/@soukainasing1/video/7370790114802322694 ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the video statistics and metadata. - **url** (string) - The original TikTok URL provided. - **title** (string) - The video title/caption with hashtags. - **channelName** (string) - The TikTok username. - **channelLink** (string) - The link to the TikTok channel. - **likes** (integer) - Total like count. - **comments** (integer) - Total comment count. - **shares** (integer) - Total share count. - **views** (integer) - Total view count. - **description** (string) - The video description/caption. - **duration** (string) - Video duration in MM:SS format. - **thumbnailUrl** (string) - URL to the video thumbnail image. #### Response Example ```json { "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" } } ``` ``` -------------------------------- ### GET /tiktok/transcript Source: https://docs.socialkit.dev/api-reference/tiktok-transcript-api Retrieves the transcript for a given TikTok video URL. It supports full text transcripts and timestamped segments, useful for various applications like content analysis, accessibility, and search. ```APIDOC ## GET /tiktok/transcript ### Description Retrieves the transcript for a given TikTok video URL. It supports full text transcripts and timestamped segments, useful for various applications like content analysis, accessibility, and search. ### Method GET ### Endpoint https://api.socialkit.dev/tiktok/transcript ### Parameters #### Query Parameters - **url** (string) - Required - The TikTok URL of the video to extract transcript from. Supports various TikTok URL formats. - **access_key** (string) - Required - Your API access key. Can be provided via the `access_key` query parameter, `x-access-key` header, or request body. - **cache** (boolean) - Optional - Defaults to false. Cache the response for faster subsequent requests. - **cache_ttl** (number) - Optional - Defaults to 2592000. Cache the response for a custom TTL (in seconds). Maximum `2592000` seconds (1 month), minimum `3600` seconds (1 hour). ### Request Example ``` GET https://api.socialkit.dev/tiktok/transcript?access_key=&url=https://www.tiktok.com/@thepeteffect/video/7522711492140059912 ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the transcript information. - **url** (string) - The TikTok URL of the video. - **transcript** (string) - Complete text transcript of the TikTok video. - **transcriptSegments** (array) - Array of timestamped transcript segments. - **text** (string) - The spoken text for this segment. - **start** (number) - Start time in seconds. - **duration** (number) - Duration of the segment in seconds. - **timestamp** (string) - Human-readable timestamp (MM:SS format). - **wordCount** (integer) - Total number of words in the transcript. - **segments** (integer) - Total number of transcript segments. #### Response Example ```json { "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" } ], "wordCount": 157, "segments": 23 } } ``` ``` -------------------------------- ### YouTube Video Summary API Source: https://docs.socialkit.dev/getting-started Provides a summary for a given YouTube video URL. Requires an access key for authentication. ```APIDOC ## GET /youtube/summarize ### Description This endpoint retrieves a summary for a YouTube video. ### Method GET ### Endpoint `/youtube/summarize` ### Parameters #### Query Parameters - **access_key** (string) - Required - Your SocialKit access key. - **url** (string) - Required - The URL of the YouTube video. ### Request Example ``` GET https://api.socialkit.dev/youtube/summarize?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the video summary details. - **url** (string) - The original video URL. - **summary** (string) - A concise summary of the video content. - **mainTopics** (array of strings) - Key topics discussed in the video. - **keyPoints** (array of strings) - Important points from the video. - **tone** (string) - The overall tone of the video. - **targetAudience** (string) - The intended audience for the video. - **quotes** (array of strings) - Notable quotes from the video. - **timeline** (string) - A description of the video's structure or progression. #### Response Example ```json { "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 API Source: https://docs.socialkit.dev/getting-started Provides a summary for a given TikTok video URL. Requires an access key for authentication. ```APIDOC ## GET /tiktok/summarize ### Description This endpoint retrieves a summary for a TikTok video. ### Method GET ### Endpoint `/tiktok/summarize` ### Parameters #### Query Parameters - **access_key** (string) - Required - Your SocialKit access key. - **url** (string) - Required - The URL of the TikTok video. ### Request Example ``` GET https://api.socialkit.dev/tiktok/summarize?access_key=&url=https://www.tiktok.com/@thepeteffect/video/7522711492140059912 ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the video summary details. - **url** (string) - The original video URL. - **summary** (string) - A concise summary of the video content. - **mainTopics** (array of strings) - Key topics discussed in the video. - **keyPoints** (array of strings) - Important points from the video. - **tone** (string) - The overall tone of the video. - **targetAudience** (string) - The intended audience for the video. - **quotes** (array of strings) - Notable quotes from the video. - **timeline** (string) - A description of the video's structure or progression. #### Response Example ```json { "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 Summary API Source: https://docs.socialkit.dev/api-reference/youtube-summarize-api This API endpoint analyzes a given YouTube video URL and returns a comprehensive summary, main topics, key points, tone, target audience, quotes, and timeline of the video content. ```APIDOC ## GET /youtube/summarize ### Description Analyzes a YouTube video and returns an AI-generated summary, key insights, main topics, and detailed analysis. ### Method GET ### Endpoint `https://api.socialkit.dev/youtube/summarize` ### Parameters #### Query Parameters - **url** (string) - Required - The YouTube URL of the video to analyze. Supports various YouTube URL formats. - **access_key** (string) - Required - Your API access key. Can be provided via the `access_key` query parameter, `x-access-key` header, or request body. - **custom_response** (object | string) - Optional - Define custom fields for the AI response. This allows you to extract specific information tailored to your needs. Example: ```json { "title": "Video title", "sentiment": "Overall sentiment of the video", "isMusic": "Whether the video is a music video", "category": "Video category or genre", "language": "Primary language spoken in the video" } ``` - **custom_prompt** (string) - Optional - Add your own instructions to guide the AI’s analysis. For example: “Make it short and concise”, “Write in Spanish”, “Focus on technical aspects”, etc. - **cache** (boolean) - Optional - Defaults to false. Cache the response for faster subsequent requests. - **cache_ttl** (number) - Optional - Defaults to 2592000. Cache the response for a custom TTL (in seconds). Maximum `2592000` seconds (1 month), minimum `3600` seconds (1 hour). ### Request Example ``` GET https://api.socialkit.dev/youtube/summarize?access_key=&url=https://youtube.com/watch?v=dQw4w9WgXcQ ``` ### Response #### Success Response (200) - **success** (boolean) - Indicates if the request was successful. - **data** (object) - Contains the analysis results. - **url** (string) - The analyzed YouTube URL. - **summary** (string) - A concise summary of the video content. - **mainTopics** (array) - An array of the main topics discussed in the video. - **keyPoints** (array) - An array of key takeaways or important points from the video. - **tone** (string) - The overall tone of the video content. - **targetAudience** (string) - The intended audience for the video. - **quotes** (array) - Notable quotes from the video. - **timeline** (string) - A description of the video's structure or timeline. #### Response Example ```json { "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." } } ``` ```