# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-clastify-com-api-13065854/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-clastify-com-api-13065854/get_essay_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-clastify-com-api-13065854/search_essays \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"application_year":"<string>","grade":"<string>","page":"<integer>","prompt":"<string>","query":"<string>"}'
```