POST/v1/studio/score

Score Content

Submits a piece of content (text, image URL, or video URL) for PRISM Studio scoring. Returns predicted pillar impact and optimization feedback. Useful for building custom content creation workflows.

Bearer token required. Minimum plan: Agency.

Request Body

ParameterTypeRequiredDescription
content_typestringRequired"text", "image", or "video".
contentstringRequiredText content or URL to image/video.
platformstringRequiredTarget platform: "instagram", "tiktok", "youtube", "twitter", "linkedin", "pinterest".
formatstringOptional"post", "story", "reel", "short", "thread". Default: "post".
Request
curl -X POST "https://api.onprism.io/v1/studio/score" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content_type": "text",
    "content": "Stop chasing followers. Our data shows that Momentum — not audience size — predicts revenue growth. Here is why consistency beats virality every time.",
    "platform": "linkedin",
    "format": "post"
  }'
Response (200 OK)
{
  "score": 72,
  "pillar_predictions": {
    "impact": "+5",
    "reach": "+2",
    "momentum": "+1",
    "presence": "+1",
    "sentiment": "+1"
  },
  "feedback": [
    { "priority": 1, "suggestion": "Add a data point or statistic to strengthen the opening claim.", "expected_lift": "+3" },
    { "priority": 2, "suggestion": "End with a question to drive comments and boost Impact.", "expected_lift": "+2" },
    { "priority": 3, "suggestion": "Include a relevant hashtag for discoverability.", "expected_lift": "+1" }
  ],
  "platform": "linkedin",
  "format": "post"
}

Error Codes

400

Invalid Content Type

content_type must be "text", "image", or "video".

401

Unauthorized

Missing or invalid API key.

413

Content Too Large

Text content exceeds 10,000 characters or media exceeds 100MB.

422

Invalid Platform

Platform not recognized. Must be one of the supported platforms.

Previous

Get Audit Results

GET /v1/audit/{audit_id}

Next

List Campaigns

GET /v1/campaigns