PHPackages                             hadi-aghandeh/carnegie-text-service - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. hadi-aghandeh/carnegie-text-service

ActiveLibrary[API Development](/categories/api)

hadi-aghandeh/carnegie-text-service
===================================

a wrapper around carnegie text service API

1.0.11(1y ago)144MITPHP

Since Jul 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/HadiAghandeh/carnegie-text-services)[ Packagist](https://packagist.org/packages/hadi-aghandeh/carnegie-text-service)[ RSS](/packages/hadi-aghandeh-carnegie-text-service/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (1)Versions (13)Used By (0)

CarnegieTextService PHP Package
===============================

[](#carnegietextservice-php-package)

Overview
--------

[](#overview)

The `CarnegieTextService` PHP package provides a set of functionalities to interact with the Carnegie Text Service API. This package allows users to grade texts and manage essays using the provided API endpoints.

**This project is an unofficial wrapper for the Carnegie Text Service API. It is not endorsed or certified by Carnegie Speech or any similar companies. Use at your own risk.**

**To use Carnegie Text Service API you need to obtain credentials from Carnegie Speech**

Installation
------------

[](#installation)

To install the package, use Composer:

```
composer require hadi-aghandeh/carnegie-text-service
```

Usage
=====

[](#usage)

```
use HadiAghandeh\CarnegieTextService\CarnegieTextService;

$password = 'your_password';
$requester = 'your_requester';
requesterID = 'your_requesterID';

$service = new CarnegieTextService($password, $requester, $requesterID);

// Grading an essay
$response = $service->gradeText('essay123', 'user456', 'This is the content of the essay.');
print_r($response);
/*
[
  "overall" => 3.25
  "lexical" => 3
  "task" => 3
  "grammar" => 5
  "cohesion" => 2
]
*/

// Adding a new essay
$response = $service->addEssay(
    'essay123', // essay ID
    'What is the meaning of life? Why are we here?', // question
    'The meaning of life is to seek knowledge and understanding, to continuously grow and evolve, and to contribute to the well-being of others. We are here to experience, learn, and find our own purpose through the connections we make and the actions we take. ', // example response 1
    'The meaning of life is to achieve spiritual enlightenment and fulfillment. We are here to learn important life lessons, to develop compassion and love, and to realize our interconnectedness with all living beings and the universe.', // example response 2
    'The meaning of life is a product of evolution and the natural processes that led to our existence. We are here as a result of the biological imperative to survive, reproduce, and pass on our genes, while also having the capacity to explore, understand, and shape our environment.' // example response 3
);
print_r($response);

/*
[
  "status" => "success"
  "data" => array:1 [
    "essay" => array:1 [
      "essay_id" => "essay123"
    ]
  ]
  "message" => "New essay added successfully."
]
 */

// Updating an existing essay
$response = $service->updateEssay('essay123', 'Updated question?', 'Updated essay 1 content', 'Updated essay 2 content', 'Updated essay 3 content');
print_r($response);
```

License
=======

[](#license)

This package is open-sourced software licensed under the MIT license.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance39

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~12 days

Recently: every ~3 days

Total

12

Last Release

519d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0cf0eb705be83687b56c9fb1284b298815d86025fe6f87c048aae9e45a7302f2?d=identicon)[aghandeh](/maintainers/aghandeh)

---

Top Contributors

[![HadiAghandeh](https://avatars.githubusercontent.com/u/28506997?v=4)](https://github.com/HadiAghandeh "HadiAghandeh (20 commits)")

### Embed Badge

![Health badge](/badges/hadi-aghandeh-carnegie-text-service/health.svg)

```
[![Health](https://phpackages.com/badges/hadi-aghandeh-carnegie-text-service/health.svg)](https://phpackages.com/packages/hadi-aghandeh-carnegie-text-service)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)