# Clastify — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search through real Common App essay examples to find samples by grade, applicant profile, and college outcomes, then view detailed essays along with the writer's test scores and admission results. Use this to understand what successful essays look like and how they compare across different colleges and student profiles.

**Category:** Education | **Website:** [www.clastify.com/common-app-essay-examples](https://www.clastify.com/common-app-essay-examples) | **Docs:** [parse.bot/marketplace/13065854-3cc1-4b04-9884-2bc3105626b9/clastify-com-api](https://parse.bot/marketplace/13065854-3cc1-4b04-9884-2bc3105626b9/clastify-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/clastify/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get essay detail

Get detailed information about a specific Common App essay example by its ID (obtained from search_essays results). Returns essay metadata including grade, prompt, applicant profile, college decisions, and test scores.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `essay_id` | string | Yes | Essay ID from search_essays results (e.g. '66d212a5dcd6972e18b57a79'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/clastify/get-essay-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"essay_id":"<string>"}'
```

### Search essays

Search Common App essay examples by keyword. Returns up to 100 essays per page ranked by relevance, with metadata including essay grade (A-F), prompt number, colleges accepted/rejected, applicant scores, and marking status. A non-empty search query is required.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `application_year` | string | No | Filter by application year in format 'YYYY/YYYY' (e.g. '2023/2024'). |
| `grade` | string | No | Filter by essay grade. Only essays with completed marking have grades. |
| `page` | integer | No | Page number for pagination. |
| `prompt` | string | No | Filter by Common App prompt number (e.g. '1', '2', '3', '4', '5', '6', '7'). |
| `query` | string | Yes | Search keywords to find relevant essay examples (e.g. 'leadership', 'diversity', 'family'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/clastify/search-essays \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"application_year":"<string>","grade":"<string>","page":"<integer>","prompt":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.