# Aquinas — 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 and retrieve bilingual texts from Thomas Aquinas's philosophical and theological works, with the ability to find specific articles and statements across the entire collection. Access organized works by reference or use global search to discover relevant passages on topics within Aquinas's writings.

**Category:** Education | **Website:** [aquinas.cc/](https://aquinas.cc/) | **Docs:** [parse.bot/marketplace/b451b92f-9b03-4004-b0ae-520d763b3bf9/aquinas-cc-api](https://parse.bot/marketplace/b451b92f-9b03-4004-b0ae-520d763b3bf9/aquinas-cc-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-aquinas-cc-api-b451b92f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article

Retrieve parallel Latin/English text for a specific article reference within a work. Returns cell-level bilingual content with cell IDs that correspond to paragraph-level segments. Each cell contains the original Latin and its English translation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ref` | string | Yes | Article reference within the work, formatted as WorkCode.Q{number}.A{number} (e.g. ST.I.Q2.A2, ST.III.Q2.A2) |
| `work` | string | Yes | Work code from list_works (e.g. ST.I, ST.III, SCG1) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aquinas-cc-api-b451b92f/get_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ref":"<string>","work":"<string>"}'
```

### get_statements

Extract statements matching a query term from across the library. Searches Latin text and returns matching passages with their English translations. Limited to 20 results from the top 5 works by hit count. Useful for finding specific theological or philosophical concepts across the corpus.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Latin term to search for in the text (e.g. subsistendi, gratia) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aquinas-cc-api-b451b92f/get_statements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### list_works

List all available works in the Aquinas library with their internal work IDs and work codes. Returns a list of works with code and numeric ID that can be used with other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aquinas-cc-api-b451b92f/list_works \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search

Search for a term across all works in the Aquinas library. Returns a list of works containing the term with hit counts. Searches Latin text by default. Supports exact match, any word, all words, and regex modes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `mode` | string | No | Search mode. |
| `query` | string | Yes | Search term to find across all works (Latin or English text) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aquinas-cc-api-b451b92f/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"<string>","query":"<string>"}'
```
