Skip to main content
POST
/
v1
/
content
/
score
Score Content
curl --request POST \
  --url https://app.uselamina.ai/v1/content/score \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "platform": "instagram",
  "modality": "image",
  "limit": 10
}
'
{
  "data": {
    "scores": [
      {
        "contentItemId": "item-001",
        "overallScore": 88.5,
        "dimensions": {
          "brandAlignment": 92,
          "predictedEngagement": 85,
          "visualQuality": 90,
          "platformFitness": 87
        },
        "feedback": "Strong brand alignment. Consider adding a call-to-action for higher engagement."
      },
      {
        "contentItemId": "item-002",
        "overallScore": 62,
        "dimensions": {
          "brandAlignment": 55,
          "predictedEngagement": 68,
          "visualQuality": 72,
          "platformFitness": 53
        },
        "feedback": "Visual style doesn't match brand guidelines. Try warmer tones and lifestyle setting."
      }
    ]
  }
}
Evaluate workspace content across multiple quality dimensions including brand alignment, visual quality, and engagement potential. Pass contentItemIds to score specific items, or use the platform and modality filters to score recent content matching those criteria. Results include per-dimension breakdowns useful for automated quality gates, ranking content variants, or building review dashboards.

Authorizations

​
x-api-key
string
header
required

Workspace API key. Prefix: lma_. Example: lma_abc123...

Body

application/json
​
contentItemIds
string<uuid>[] | null

Specific content item IDs to score. Omit to score recent workspace content.

​
platform
string | null

Filter content by target platform before scoring.

​
modality
string | null

Filter content by modality before scoring.

​
limit
integer
default:25

Maximum number of items to score (when not providing specific IDs).

Response

Content scores and evaluation details

​
data
object

Scoring results. Structure varies based on the workspace's intelligence model.