Skip to content
Sociable AI Documentation

Post Detail

Post detail

Section titled “Post detail”
GET https://api.sociable.how/v1/posts/:id

Returns full detail for a single Instagram post, including creator information, an analysis summary, notable moments, and the transcript. Use the id from a search result.

Headers

Section titled “Headers”
  • Authorization: required. Bearer sk_live_<YOUR_API_KEY>.

Example request

Section titled “Example request”
Terminal window
curl -sS "https://api.sociable.how/v1/posts/1f158f47-d5f2-6d59-a389-0d6aeb322a9b" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Example response

Section titled “Example response”
{
  "post": {
    "id": "1f158f47-d5f2-6d59-a389-0d6aeb322a9b",
    "platform": "Instagram",
    "url": "https://www.instagram.com/reel/DYnrGcgPQRl/",
    "caption": "Just opened a Fidelity Roth IRA with $50 and had NO idea what to do next. So I'm walking through the whole thing 👇🏾",
    "thumbnailUrl": "https://scontent.cdninstagram.com/v/t51.../thumbnail.jpg",
    "mediaUrl": "https://scontent.cdninstagram.com/o1/v/t2/.../video.mp4",
    "creatorHandle": "@financiallyintentional",
    "metrics": { "likes": 36700, "comments": 1944 }
  },
  "creator": {
    "handle": "@financiallyintentional",
    "name": "financiallyintentional",
    "followers": 250001,
    "category": "Education website",
    "bio": "Helping mommies get rich and raise rich kids 📰 Featured in Forbes & CNBC 📋 Get Rich for you and your kids 👇🏾",
    "isVerified": true
  },
  "analysis": {
    "summary": "A screen-recorded walkthrough of opening and funding a Fidelity Roth IRA: choosing a zero-fee index fund, placing a first $50 order, and setting up a recurring $10 monthly investment, framed as a beginner-friendly response to a viewer's question."
  },
  "highlights": [
    {
      "time": "0:15",
      "seconds": 15,
      "title": "Fidelity App Walkthrough",
      "explanation": "The creator demonstrates how to navigate the Fidelity app interface."
    },
    {
      "time": "0:30",
      "seconds": 30,
      "title": "Zero-Fee Index Funds",
      "explanation": "The creator identifies specific zero-fee investment options available within the app."
    },
    {
      "time": "1:04",
      "seconds": 64,
      "title": "Automating Investments",
      "explanation": "The creator shows how to set up a recurring monthly investment in the Fidelity app."
    }
  ],
  "transcript": "0:00 The creator responds to a viewer who asked for advice after opening a Fidelity Roth IRA with $50, and tells everyone else to keep scrolling. 0:15 A screen recording begins; she opens the Fidelity app. 0:30 She highlights zero-fee index funds such as FNILX and FZROX. 1:04 She sets up a recurring investment. 1:22 The recurring details are shown — $10.00, monthly — and she confirms."
}

Fields

Section titled “Fields”
  • post: the post card, the same shape returned in search results (id, platform, url, caption, thumbnailUrl, mediaUrl, creatorHandle, metrics).
  • creator: information about the creator.
    • handle: the creator’s handle, including the leading @.
    • name: the creator’s name.
    • followers: follower count.
    • category: the creator’s account category.
    • bio: the creator’s bio text.
    • isVerified: whether the account is verified.
  • analysis: generated analysis of the post.
    • summary: a short description of what the post is about.
  • highlights: notable moments in the post.
    • time: human-readable timestamp, e.g. 0:15.
    • seconds: the same moment in seconds.
    • title: a short title for the moment.
    • explanation: what happens at that moment.
  • transcript: a timestamped transcript of the post.

If the post does not exist, the API returns 404.

thumbnailUrl and mediaUrl are time-limited, signed Instagram CDN links that expire. Fetch or cache them promptly.