Read stored enriched posts

Posts

post /v1/posts/enriched

Returns the stored Enriched projection without starting a live refresh. The response includes safe nested content analysis, post-item and media hierarchy, coverage, and transcript metadata but no stored bytes, download URLs, transcript content, prompts, or raw analysis.

Authentication

ApiKey bearer token

Send the current Benchmark API key only in the Authorization header.

Request body

target EntityTarget required

A Benchmark entity UUID, platform-native ID, handle, or public URL. Platform can be omitted when the URL identifies it. Link targets require a public HTTPS URL or an existing Benchmark link UUID; HTTP, credentials, local/internal hosts, and non-443 ports are rejected.

Responses

200
The stored enriched entity.
400
The request failed validation.
401
The bearer credential is missing or invalid.
402
The organization needs plan or purchased-credit entitlement, has reached its separate monthly spend cap, or cannot cover the operation within the entitled grace floor.
403
The key cannot perform this operation.
404
The canonical entity is not stored. The error includes the exact refresh request that can create it.
429
The Cloudflare rate limiter rejected the request.
500
The request failed without exposing internal diagnostics.
503
A required service is unavailable.

curl --request POST \ --url "${BENCHMARK_API_BASE_URL}/v1/posts/enriched" \ --header "Authorization: Bearer ${BENCHMARK_API_KEY}" \ --header "Content-Type: application/json" \ --data '{"target":{"reference":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}}'

{ "data": { "entityType": "post", "entityId": "30000000-0000-4000-8000-000000000003", "platform": "youtube", "platformId": "dQw4w9WgXcQ", "canonicalUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "creatorEntityId": "50000000-0000-4000-8000-000000000005", "creatorPlatformId": "UCBJycsmduvYEL83R_U4JriQ", "collaborators": [], "title": "Example video", "caption": "An example public post.", "publishedAt": "2026-08-20T15:00:00.000Z", "language": "en", "contentType": "video", "metrics": { "bookmarkCount": null, "commentCount": 120, "impressionCount": null, "likeCount": 8400, "quoteCount": null, "repostCount": null, "saveCount": null, "shareCount": 310, "videoPlayCount": null, "viewCount": 124000 }, "observedAt": "2026-08-24T12:00:00.000Z", "outlier": { "baselineMedianReach": 52000, "baselineN": 24, "computedAt": "2026-08-24T12:00:01.000Z", "formulaVersion": "outlier-v1", "priorityScore": 0.74, "reachMetric": "view", "reachMultiplier": 2.3846153846153846, "reachPercentile": 0.91, "reviewTier": "not_qualified", "robustZ": 1.9 }, "nativeTags": [ "technology" ], "platformMetadata": { "category": "Science & Technology" }, "durationMs": 614000, "analysis": { "common": { "analysisContentType": "longform_video", "categories": [ "education" ], "description": "An educational video that explains a technical topic.", "emotions": [ "curiosity" ], "entities": [ "Benchmark" ], "estimatedTargetAudience": "Developers learning about public data APIs", "formats": [ "explainer" ], "keywords": [ "public data", "API" ], "llmSentiment": "positive", "styles": [ "educational" ], "topics": [ "public data infrastructure" ] }, "subject": { "overallNarrative": "The video introduces a problem and explains a practical solution." }, "templates": [] }, "items": [ { "itemId": "70000000-0000-4000-8000-000000000007", "itemType": "root", "platformItemId": "dQw4w9WgXcQ", "position": 0, "publishedAt": "2026-08-20T15:00:00.000Z", "quotedPlatformPostId": null, "text": "An example public post.", "analysis": { "introText": "A concise introduction frames the technical problem." }, "media": [ { "analysis": { "introTemplate": "State the problem, then establish the promised outcome." }, "altText": null, "availability": "available", "coverage": { "issues": [], "status": "complete" }, "durationMs": 614000, "hasAudio": true, "height": 1080, "mediaId": "80000000-0000-4000-8000-000000000008", "mediaType": "video", "origin": "source", "parentMediaId": null, "position": 0, "role": "source_video", "transcript": null, "width": 1920 }, { "altText": null, "availability": "available", "coverage": { "issues": [], "status": "complete" }, "durationMs": 614000, "hasAudio": null, "height": null, "mediaId": "80000000-0000-4000-8000-000000000009", "mediaType": "text", "origin": "derived", "parentMediaId": "80000000-0000-4000-8000-000000000008", "position": 1, "role": "transcript", "transcript": { "durationMs": 614000, "language": "en", "segmentCount": 412 }, "width": null } ] } ], "isEnriched": true }, "meta": { "entityId": "30000000-0000-4000-8000-000000000003", "dataLevel": "enriched", "coverage": { "issues": [], "status": "complete" }, "freshness": "current", "observedAt": "2026-08-24T12:00:00.000Z" } }