# Gregmat — 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.

> Explore GregMat's comprehensive GRE preparation resources by accessing study plans tailored to your learning pace, browsing video courses and recorded classes, and working through practice problems. Discover structured learning paths and stay updated with recently added course materials to guide your test prep journey.

**Category:** Education | **Website:** [www.gregmat.com/](https://www.gregmat.com/) | **Docs:** [parse.bot/marketplace/8ac79cd0-4c4c-432f-ab1d-3731b12ce1b7/gregmat-com-api](https://parse.bot/marketplace/8ac79cd0-4c4c-432f-ab1d-3731b12ce1b7/gregmat-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-gregmat-com-api-8ac79cd0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_course

Get a video course by slug, including all class groups and their individual class entries. Each class has a title, slug, description, image, and type. Class groups organize classes into thematic sections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL slug of the course (e.g. 'must-see-videos'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gregmat-com-api-8ac79cd0/get_course \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_study_plan

Get a specific study plan by slug, including all units with their content. Units contain HTML descriptions with links to videos, courses, and problems. Units may be marked plus_only independently of the plan itself.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL slug of the study plan. Available from list_study_plans results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gregmat-com-api-8ac79cd0/get_study_plan \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_problems

List GRE practice problems with optional filters for category, difficulty, question type, tags, and text search. Returns paginated problem listings with metadata including acceptance rate, difficulty, and whether a solution video exists.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Problem category. |
| `difficulty` | string | No | Filter by difficulty level. |
| `limit` | integer | No | Maximum number of problems to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |
| `query` | string | No | Text search query to filter problems by title content. |
| `question_type` | string | No | Filter by question type (e.g. 'Quantitative Comparison', 'Multiple Choice', 'Numeric Entry (Not Fraction)', 'Multiple Select', 'TC 1 Blank'). |
| `tag` | string | No | Filter by tag ID number (e.g. '1' for Triangles, '2' for Fractions). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gregmat-com-api-8ac79cd0/list_problems \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","difficulty":"<string>","limit":"<integer>","offset":"<integer>","query":"<string>","question_type":"<string>","tag":"<string>"}'
```

### list_recent_classes

List recently completed classes (video recordings) with pagination. Returns class details including title, slug, type, schedule times, and associated courses. Ordered by most recent first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of classes to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gregmat-com-api-8ac79cd0/list_recent_classes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### list_study_plans

List all available GRE study plans with pagination. Returns plan titles, slugs, and whether they require a Plus subscription. Each plan can be fetched in detail via get_study_plan.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of study plans to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-gregmat-com-api-8ac79cd0/list_study_plans \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```