Content

Score Content

Request Body

string

required

Valid URL to score (must be a publicly accessible webpage)

Response

ContentScore

The content score result

Show ContentScore properties

string

required

Unique score identifier

string

required

User who requested the score

string

required

URL that was scored

number

required

Overall content score (0-100)

number | null

Structure and formatting score (0-100)

number | null

Readability and clarity score (0-100)

number | null

Content freshness score (0-100)

number | null

Key content quality score (0-100)

number | null

Citation and reference score (0-100)

ContentRecommendation[]

required

Array of actionable recommendations

Show ContentRecommendation properties

string

Dimension of the recommendation (structure, readability, freshness, key_content, citation)

string

Human-readable recommendation message

string

Priority level: high, medium, or low

string

required

ISO 8601 timestamp when content was scored

Example Request

curl -X POST "https://api.opensight.ai/api/content/score" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/blog/how-to-improve-seo"
  }'

Example Response

{
  "score": {
    "id": "score_123",
    "user_id": "user_456",
    "url": "https://example.com/blog/how-to-improve-seo",
    "overall_score": 78,
    "structure_score": 85,
    "readability_score": 72,
    "freshness_score": 90,
    "key_content_score": 75,
    "citation_score": 68,
    "recommendations": [
      {
        "dimension": "citation",
        "message": "Add more authoritative external citations to strengthen credibility",
        "priority": "high"
      },
      {
        "dimension": "readability",
        "message": "Break up long paragraphs for better readability",
        "priority": "medium"
      },
      {
        "dimension": "key_content",
        "message": "Include more specific examples and case studies",
        "priority": "medium"
      }
    ],
    "scored_at": "2024-01-15T10:30:00Z"
  }
}

Errors

429 Too Many Requests - Daily content scoring limit reached for your plan
400 Bad Request - Invalid URL or URL is not accessible

Rate Limits

Free: 5 content scores per day
Starter: 25 content scores per day
Growth: 100 content scores per day

Get Score History

Query Parameters

string

Number of results to return (default: 50, max: 50)

string

Number of results to skip for pagination (default: 0)

Response

ContentScore[]

Array of content score objects (see Score Content response for object structure)

number

Total number of scores in history

number

Applied limit

number

Applied offset

Example Request

curl -X GET "https://api.opensight.ai/api/content/score/history?limit=10&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "scores": [
    {
      "id": "score_123",
      "user_id": "user_456",
      "url": "https://example.com/blog/how-to-improve-seo",
      "overall_score": 78,
      "structure_score": 85,
      "readability_score": 72,
      "freshness_score": 90,
      "key_content_score": 75,
      "citation_score": 68,
      "recommendations": [
        {
          "dimension": "citation",
          "message": "Add more authoritative external citations",
          "priority": "high"
        }
      ],
      "scored_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0
}

Getting Started

Endpoints

Score Content

Request Body

Response

Example Request

Example Response

Errors

Rate Limits

Get Score History

Query Parameters

Response

Example Request

Example Response

​Score Content

​Request Body

​Response

​Example Request

​Example Response

​Errors

​Rate Limits

​Get Score History

​Query Parameters

​Response

​Example Request

​Example Response

Score Content

Request Body

Response

Example Request

Example Response

Errors

Rate Limits

Get Score History

Query Parameters

Response

Example Request

Example Response