Skip to main content
POST
/
evaluations
/
social-media
{
  "evaluation_id": "<string>",
  "platform": "<string>",
  "content_type": "<string>",
  "overall_score": 123,
  "compliance_status": "<string>",
  "criteria_scores": [
    {
      "criterion_name": "<string>",
      "score": 123,
      "status": "<string>",
      "feedback": "<string>"
    }
  ],
  "risk_factors": [
    {
      "type": "<string>",
      "severity": "<string>",
      "description": "<string>",
      "confidence": 123
    }
  ],
  "recommendations": [
    {}
  ],
  "sentiment": {
    "polarity": "<string>",
    "confidence": 123,
    "emotions": [
      {}
    ]
  },
  "evaluated_at": {}
}

​
Overview

Evaluates social media content against platform-specific guidelines, content policies, and quality standards. This endpoint handles various social media formats and provides specialized analysis for posts, comments, stories, and other social content.

​
Request Body

​
content
string
required
The social media content to evaluate (text, caption, or description)
​
platform
string
required
Social media platform type
  • twitter - Twitter/X posts and replies
  • facebook - Facebook posts and comments
  • instagram - Instagram posts and stories
  • linkedin - LinkedIn posts and articles
  • tiktok - TikTok video descriptions
  • youtube - YouTube video descriptions and comments
  • reddit - Reddit posts and comments
​
content_type
string
required
Type of social media content
  • post - Main content post
  • comment - Comment or reply
  • story - Temporary story content
  • bio - Profile biography
  • caption - Media caption
​
judge_id
string
required
ID of the judge to use for evaluation
​
metadata
object
Additional content metadata
​
evaluation_options
object
Evaluation configuration options

​
Response

​
evaluation_id
string
required
Unique identifier for the evaluation
​
platform
string
required
Social media platform
​
content_type
string
required
Type of social content evaluated
​
overall_score
number
required
Overall evaluation score (0-100)
​
compliance_status
string
required
Platform compliance status
  • compliant - Meets all platform guidelines
  • warning - Minor issues detected
  • violation - Policy violations found
  • banned - Content would be banned/removed
​
criteria_scores
array
required
Individual criteria evaluation results
​
risk_factors
array
Identified risk factors
​
recommendations
array
Content improvement recommendations
​
sentiment
object
Sentiment analysis results (if enabled)
​
evaluated_at
datetime
required
Evaluation timestamp

​
Examples

curl -X POST https://api.judge.example.com/evaluations/social-media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Check out this amazing new product! #innovation #tech #startup 🚀",
    "platform": "twitter",
    "content_type": "post",
    "judge_id": "jdg_social001",
    "metadata": {
      "hashtags": ["#innovation", "#tech", "#startup"],
      "mentions": [],
      "media_count": 0,
      "target_audience": "professional",
      "language": "en"
    },
    "evaluation_options": {
      "check_toxicity": true,
      "check_spam": true,
      "check_compliance": true,
      "sentiment_analysis": true
    }
  }'

curl -X POST https://api.judge.example.com/evaluations/social-media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "This content contains inappropriate language and harassment",
    "platform": "facebook",
    "content_type": "comment",
    "judge_id": "jdg_social001"
  }'

curl -X POST https://api.judge.example.com/evaluations/social-media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Test content",
    "platform": "invalid_platform",
    "content_type": "post",
    "judge_id": "jdg_social001"
  }'