# Gradschools — 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 graduate programs across multiple categories and discover articles about funding, financial aid, and admissions to help guide your grad school journey. Find specific program information and detailed resources all in one place to support your application and enrollment decisions.

**Category:** Education | **Website:** [gradschools.com/](https://gradschools.com/) | **Docs:** [parse.bot/marketplace/f0c20422-0027-4932-a854-3f32e6d21ef3/gradschools-com-api](https://parse.bot/marketplace/f0c20422-0027-4932-a854-3f32e6d21ef3/gradschools-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-gradschools-com-api-f0c20422/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article_detail

Returns the full content of an informational article given its URL. Provides both plain text content and the raw HTML content of the article body.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the article (e.g., from get_informed_articles results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gradschools-com-api-f0c20422/get_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_informed_articles

Returns a list of informational articles from the Student Guide section. Articles cover topics like study tips, career advice, and graduate school preparation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gradschools-com-api-f0c20422/get_informed_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_informed_categories

Returns categories for informational articles available in the Get Informed section. Each category has a display name and a URL slug identifier.

**Estimated cost:** Metered

_No parameters required._

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

### get_program_categories

Returns the list of all major subject categories available on GradSchools.com for graduate programs. Each category has a display name and a numeric ID used for filtering programs.

**Estimated cost:** Metered

_No parameters required._

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

### search_programs

Searches for graduate programs by degree level and either a category or a specific subject. The URL is constructed as /{degree_level}/{subject_or_category}. Subject takes precedence over category when both are provided. Returns a flat list of program listings with school name, program name, degree abbreviation, and URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug (e.g., 'business', 'technology'). Used when subject is not provided. |
| `degree_level` | string | No | Degree level slug for the search path. |
| `page` | integer | No | Page number for pagination. |
| `subject` | string | No | Specific subject slug (e.g., 'accounting', 'computer-science'). Takes precedence over category. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gradschools-com-api-f0c20422/search_programs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","degree_level":"<string>","page":"<integer>","subject":"<string>"}'
```

### search_site

Performs a keyword search across the entire site for programs and articles. Returns matching results with titles, URLs, and content snippets. Supports pagination for large result sets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gradschools-com-api-f0c20422/search_site \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```