API ReferenceInstagram Summary API

Instagram Summary API

The Instagram Summary API analyzes Instagram Reels and videos to generate AI-powered summaries, extract key insights, main topics, and provide detailed analysis of video content.

Endpoint

https://api.socialkit.dev/instagram/summarize

Example Request

GET https://api.socialkit.dev/instagram/summarize?access_key=<your-access-key>&url=https://www.instagram.com/reels/DSul-0Jk56u/

Response

{
  "success": true,
  "data": {
    "url": "https://www.instagram.com/reels/DSul-0Jk56u/",
    "summary": "The video features the song 'Somebody That I Used to Know' by Gotye, which explores themes of heartbreak, nostalgia, and the complexity of past relationships. The lyrics reflect on memories of being together and the bittersweet nature of moving on.",
    "mainTopics": [
      "Heartbreak",
      "Nostalgia",
      "Relationships"
    ],
    "keyPoints": [
      "The narrator reflects on memories of a past relationship.",
      "The lyrics express the pain and loneliness felt despite being together.",
      "The song captures the feeling of being addicted to sadness after a breakup."
    ],
    "tone": "Melancholic and reflective",
    "targetAudience": "Music lovers and those experiencing relationship difficulties",
    "quotes": [
      "Now and then I think of when we were together.",
      "You can get addicted to a certain kind of sadness."
    ],
    "timeline": "The song follows an introspective narrative, moving from nostalgic memories to the realization of the relationship's end and eventual closure."
  }
}

Parameters

url string Required
The Instagram URL of the video or reel to analyze. Supports various Instagram 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:

{
  "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).

Use Cases

  • Content Research: Quickly understand video content without watching
  • Social Media Monitoring: Analyze trending videos and extract insights
  • Market Research: Understand competitor content and messaging
  • Content Creation: Get inspiration and understand successful video formats
  • Accessibility: Provide summaries for users who prefer text over video
  • Trend Analysis: Extract topics and themes from popular videos
TikTok Channel Stats APIInstagram Transcript API