# Pddikti Kemdiktisaintek — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 comprehensive information about Indonesian higher education institutions, including details about students, lecturers, universities, and their study programs from the official national education database. Quickly look up specific universities, academic staff profiles, and available degree programs to research educational options or verify institution credentials.

**Category:** Education | **Website:** [pddikti.kemdiktisaintek.go.id/search/Tsabita%20Afifah%20Khoirunnisa](https://pddikti.kemdiktisaintek.go.id/search/Tsabita%20Afifah%20Khoirunnisa) | **Docs:** [parse.bot/marketplace/1b43c018-8c62-47d3-9843-6b24a057ad8b/pddikti-kemdiktisaintek-go-id-api](https://parse.bot/marketplace/1b43c018-8c62-47d3-9843-6b24a057ad8b/pddikti-kemdiktisaintek-go-id-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/pddikti-kemdiktisaintek/`
**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 lecturer detail

Retrieve profile information for a specific lecturer (dosen) by their encrypted ID. The lecturer ID is obtained from the search endpoint's dosen results. Returns name, university affiliation, study program, academic position, and employment status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lecturer_id` | string | Yes | Encrypted lecturer ID obtained from search results (dosen[*].id). |

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

### Get student detail

Retrieve detailed biodata for a specific student (mahasiswa) by their encrypted ID. The student ID is obtained from the search endpoint's mahasiswa results. Returns name, student number, university, study program, enrollment status, and other academic information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `student_id` | string | Yes | Encrypted student ID obtained from search results (mahasiswa[*].id). |

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

### Get university detail

Retrieve detailed information for a specific university (perguruan tinggi) by its encrypted ID. The university ID can be obtained from search results (pt[*].id) or from a student's detail response (id_pt field). Returns name, accreditation, contact details, address, and geographic coordinates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `university_id` | string | Yes | Encrypted university ID obtained from search results (pt[*].id) or student detail (id_pt). |

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

### Get university programs

Retrieve the list of study programs (program studi) offered by a university in a given semester. Returns program details including name, degree level, accreditation, student count, lecturer count, and lecturer-student ratio. The university ID is obtained from search results or student detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `semester` | string | No | Semester code in format YYYYS where YYYY is the academic year and S is 1 (odd/ganjil semester) or 2 (even/genap semester). Example: 20251 means odd semester 2025, 20242 means even semester 2024. |
| `university_id` | string | Yes | Encrypted university ID obtained from search results (pt[*].id) or student detail (id_pt). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pddikti-kemdiktisaintek/get-university-programs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"semester":"<string>","university_id":"<string>"}'
```

### Search

Search across all categories (students, lecturers, universities, study programs) or a specific category in Indonesia's higher education database. When category is 'all', results are grouped by type (mahasiswa, dosen, pt, prodi). When a specific category is chosen, results are returned in a flat 'results' array. Pagination is not supported server-side; all matching results are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category to search in. |
| `keyword` | string | Yes | Search keyword (name of student, lecturer, university, or study program). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/pddikti-kemdiktisaintek/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","keyword":"<string>"}'
```

## Next steps

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