# Egyankosh — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-egyankosh-ac-in-api-fac00308/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-egyankosh-ac-in-api-fac00308/get_block_units \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-egyankosh-ac-in-api-fac00308/get_communities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-egyankosh-ac-in-api-fac00308/get_community \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-egyankosh-ac-in-api-fac00308/get_unit_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-egyankosh-ac-in-api-fac00308/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","scope":"<string>"}'
```