Developer Documentation

{
  "event": "summary.completed",
  "timestamp": "2026-06-06T14:32:01.000Z",
  "data": {
    "id": "uuid-of-the-summary",
    "video_id": "dQw4w9WgXcQ",
    "video_title": "The Original Video Title on YouTube",
    "summary_title": "AI-Generated Summary Title",
    "slug": "ai-generated-summary-title-abc123",
    "url": "https://socialsnap.io/reads/ai-generated-summary-title-abc123",
    "published_at": "2026-06-06T14:30:00.000Z",
    "channel_id": "uuid-of-the-channel",
    "tldr": "A short paragraph summarising the key point of the video.",
    "key_takeaways": [
      "First major insight from the video",
      "Second major insight from the video"
    ],
    "category": "Technology",
    "chapters": [
      {
        "title": "Chapter Title",
        "summary": "What this segment covers."
      }
    ],
    "notable_quotes": [
      {
        "quote": "Something memorable the speaker said.",
        "speaker": "Speaker Name"
      }
    ],
    "glossary": [
      {
        "term": "Technical Term",
        "definition": "Plain-English explanation."
      }
    ],
    "key_people": [
      {
        "name": "Person Name",
        "role": "Their role or relevance in the video"
      }
    ],
    "language": "en",
    "source": "channel",
    "created_at": "2026-06-06T14:32:00.000Z"
  }
}

{
  "event": "social_asset.generated",
  "timestamp": "2026-06-06T14:32:01.000Z",
  "data": {
    "platform": "x-thread",
    "content": "🚨 87% of consumers are cutting spend...",
    "source": {
      "id": "uuid-of-the-summary",
      "slug": "ai-generated-summary-title-abc123",
      "video_title": "The Original Video Title on YouTube",
      "url": "https://socialsnap.io/reads/ai-generated-summary-title-abc123"
    }
  }
}

import { createHmac } from 'crypto'

// Express example
app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-socialsnap-signature']
  const expected = 'sha256=' + createHmac('sha256', process.env.WEBHOOK_SECRET)
    .update(req.body)
    .digest('hex')

  if (signature !== expected) {
    return res.status(401).send('Invalid signature')
  }

  const event = JSON.parse(req.body)

  if (event.event === 'summary.completed') {
    console.log('New summary:', event.data.url)
    // your logic here
  } else if (event.event === 'social_asset.generated') {
    console.log('New', event.data.platform, 'post for:', event.data.source.video_title)
    // your logic here
  }

  res.sendStatus(200)
})

import hmac, hashlib
from flask import Flask, request, abort

app = Flask(__name__)
WEBHOOK_SECRET = os.environ['WEBHOOK_SECRET']

@app.route('/webhook', methods=['POST'])
def webhook():
    signature = request.headers.get('X-SocialSnap-Signature', '')
    expected = 'sha256=' + hmac.new(
        WEBHOOK_SECRET.encode(),
        request.data,
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(signature, expected):
        abort(401)

    event = request.get_json()

    if event['event'] == 'summary.completed':
        print('New summary:', event['data']['url'])
        # your logic here
    elif event['event'] == 'social_asset.generated':
        print('New', event['data']['platform'], 'post for:', event['data']['source']['video_title'])
        # your logic here

    return '', 200