Post Detail

Post detail

GET https://search-backend-s4c56s44ia-uk.a.run.app/v1/posts/:id

Returns the core post data, creator information, content analysis, and transcript for a post ID returned by search. API v1 does not return thumbnails or highlights.

Headers

• Authorization: required. Bearer sak_live_<KEY_PREFIX>.<SECRET>.

Example request

curl -sS "https://search-backend-s4c56s44ia-uk.a.run.app/v1/posts/1f158f47-d5f2-6d59-a389-0d6aeb322a9b" \
  -H "Authorization: Bearer sak_live_YOUR_KEY_PREFIX.YOUR_SECRET"

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.",
    "mediaUrl": "https://storage.googleapis.com/instagram-data/post.mp4",
    "creatorHandle": "@financiallyintentional",
    "postedAt": "2026-06-25T15:42:10.000Z",
    "metrics": {
      "likes": 36700,
      "comments": 1944
    }
  },
  "creator": {
    "handle": "@financiallyintentional",
    "name": "financiallyintentional",
    "followers": 250001,
    "category": "Education website",
    "bio": "Helping families learn to invest.",
    "isVerified": true
  },
  "analysis": {
    "subject": "Opening and funding a Fidelity Roth IRA",
    "summary": "A beginner-friendly walkthrough of opening and funding a Fidelity Roth IRA.",
    "language": "en",
    "regions": [
      {
        "code": "north_america",
        "confidence": 0.94
      }
    ],
    "format": {
      "category": "Educational",
      "subtype": "Tutorial"
    },
    "topics": [
      "Topics > Finance & Economy"
    ],
    "brands": [
      "Fidelity"
    ],
    "products": [
      {
        "name": "Roth IRA",
        "brand": "Fidelity"
      }
    ]
  },
  "transcript": "0:00 The creator introduces the account. 0:15 A screen recording begins."
}

Fields

• post: core post fields: id, platform, url, caption, GCS mediaUrl, creatorHandle, postedAt, and captured metrics.
• creator: creator handle, name, follower count, category, bio, and verification state.
• analysis.subject: short description of the post’s primary subject, or null when unavailable.
• analysis.summary: fuller description of what happens in the post.
• analysis.language: detected primary language code, or null when it cannot be determined.
• analysis.regions: inferred audience or cultural regions evidenced by the content. Each entry contains a stable code and a confidence from 0 to 1; confidence can be null for older analysis. The first entry is the primary inferred region. Regions do not identify a creator’s physical location or the location from which a post was uploaded.
• analysis.format: primary content-format category and subtype, or null when unavailable.
• analysis.topics: primary topic taxonomy paths. Secondary and merely mentioned topics are not returned.
• analysis.brands: brands detected in the content.
• analysis.products: detected products with their display name and brand. brand is null when a reliable display brand is unavailable.
• transcript: timestamped play-by-play transcript when available.

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