Evaluate Content

POST 
/content-evaluations

Submit text content for evaluation.

Request

application/json

Body

required

text Text (string)required

The text content to be evaluated.

keywords string[]

List of keywords to analyze within the text content.

Responses

200

Successful Response

application/json

Schema

Schema

quality_score

object

required

overall floatrequired

The overall quality score.

breakdown

object

required

content

object

required

purpose integerrequired

accuracy integerrequired

depth integerrequired

readability

object

required

score floatrequired

grade_level integerrequired

complex_sentences

object

required

hard integerrequired

very_hard integerrequired

total integerrequired

seo

object

required

keyword_density

object

required

oneOf

MOD1

Object with keyword percentages when keywords are provided

property name* float

MOD2

Null when no keywords are provided

top_entities

object

required

property name*

object[]

Array [

text stringrequired

count integerrequired

]

score integerrequired

metadata

object

required

word_count integerrequired

sentiment

object

required

polarity floatrequired

subjectivity floatrequired

performance

object

required

automated_metrics floatrequired

keyword_analysis floatrequired

llm_evaluation floatrequired

combine_metrics integerrequired

quality_score integerrequired

eval_id stringrequired

Example (from schema)

{
  "quality_score": {
    "overall": 0,
    "breakdown": {
      "content": {
        "purpose": 0,
        "accuracy": 0,
        "depth": 0
      },
      "readability": {
        "score": 0,
        "grade_level": 0,
        "complex_sentences": {
          "hard": 0,
          "very_hard": 0,
          "total": 0
        }
      },
      "seo": {
        "keyword_density": {},
        "top_entities": {},
        "score": 0
      }
    }
  },
  "metadata": {
    "word_count": 0,
    "sentiment": {
      "polarity": 0,
      "subjectivity": 0
    },
    "performance": {
      "automated_metrics": 0,
      "keyword_analysis": 0,
      "llm_evaluation": 0,
      "combine_metrics": 0,
      "quality_score": 0
    },
    "eval_id": "string"
  }
}

422

Validation Error

application/json

Schema

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

MOD1

string

MOD2

integer

]

msg Message (string)required

type Error Type (string)required

]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}