# Egyankosh — 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 browse educational materials from IGNOU's digital repository, retrieve course unit details, and access PDFs directly. Navigate through communities and collections to find study resources organized by subject and course structure.

**Category:** Education | **Website:** [egyankosh.ac.in/](https://egyankosh.ac.in/) | **Docs:** [parse.bot/marketplace/fac00308-1bac-4beb-97d0-b22eb678591e/egyankosh-ac-in-api](https://parse.bot/marketplace/fac00308-1bac-4beb-97d0-b22eb678591e/egyankosh-ac-in-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/egyankosh/`
**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 block units

List all units (items) within a collection by its handle. Returns paginated results with 20 items per page. Use handles obtained from get_community collections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | The handle ID of the collection (e.g. '123456789/40814'). Obtain from get_community collections. |
| `page` | integer | No | Page number for pagination, starting at 0. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/egyankosh/get-block-units \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"handle":"<string>","page":"<integer>"}'
```

### Get communities

List all top-level communities (schools) in the IGNOU Self Learning Material repository. Returns the 22 schools that form the main organizational structure.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/egyankosh/get-communities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get community

Get details, sub-communities, and collections for a specific community by its handle. Navigate the hierarchy by following handles from get_communities or from sub_communities in the response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | The handle ID of the community (e.g. '123456789/1', '123456789/19'). Obtain from get_communities or from sub_communities in previous get_community calls. |

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

### Get unit detail

Get full metadata and file URLs for a specific unit (item) by its handle. Returns title, structured metadata (contributors, issue date, publisher, URI, collections), and associated PDF file URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | The handle ID of the unit/item (e.g. '123456789/35719'). Obtain from get_block_units items or search results. |

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

### Search

Search for items across the repository by keyword. Returns paginated results with 10 items per page including date, title, handle, and contributor.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting at 0. |
| `query` | string | Yes | Search keyword (e.g. 'communication', 'mathematics'). |
| `scope` | string | No | Optional handle to limit search scope to a specific community or collection. Omitting searches all of eGyanKosh. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/egyankosh/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","scope":"<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.