Skip to main content

Score Content

Request Body

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

Response

score
ContentScore
The content score result

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

limit
string
Number of results to return (default: 50, max: 50)
offset
string
Number of results to skip for pagination (default: 0)

Response

scores
ContentScore[]
Array of content score objects (see Score Content response for object structure)
total
number
Total number of scores in history
limit
number
Applied limit
offset
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
}

Build docs developers (and LLMs) love